Skip to content

Add Database workflow skills catalog and workflows skill#837

Closed
BigSimmo wants to merge 10 commits into
mainfrom
codex/chat-ensure-unique-tree-pr-94f3
Closed

Add Database workflow skills catalog and workflows skill#837
BigSimmo wants to merge 10 commits into
mainfrom
codex/chat-ensure-unique-tree-pr-94f3

Conversation

@BigSimmo

@BigSimmo BigSimmo commented Jul 18, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add a Database skill index file at .agents/skills/database-skills.md describing all local Database skills for this worktree.
  • Add a new workflows skill definition at .agents/skills/workflows/SKILL.md explaining each workflow skill and recommended usage.
  • Add the companion workflows interface prompt metadata file at .agents/skills/workflows/agents/openai.yaml.

Verification

  • git status confirmed only the intended three untracked skill files before staging.
  • git add + git commit created commit d22a9894e with the three workflow files.
  • git push pushed the branch to origin/codex/chat-ensure-unique-tree-pr-94f3.
  • Verification not run: full regression suite, because this change is documentation/metadata-only with no runtime impact.

Risk and rollout

  • Risk: low — no runtime, API, clinical, database, or UI behavior changed.
  • Rollback: close the PR and/or revert commit d22a9894e if needed.

Summary by CodeRabbit

  • New Features

    • Added offline-first workflow planners for database changes, clinical evidence, design reviews, RAG evaluations, operator closeout, lifecycle management, and verification triage.
    • Added repository skills and guidance for planning, approval gates, local checks, evidence capture, and safe execution.
    • Added portable workflow discovery and execution support.
    • Added structured workflow plans, JSON output, and evidence files.
  • Documentation

    • Added workflow catalogs, usage guidance, and updated repository contribution instructions.
  • Tests

    • Added coverage for risk classification, safety gates, CLI validation, portability, and evidence generation.

@supabase

supabase Bot commented Jul 18, 2026

Copy link
Copy Markdown

This pull request has been ignored for the connected project sjrfecxgysukkwxsowpy because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

@coderabbitai

coderabbitai Bot commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The head commit changed during the review from f595a95 to cd89ae5.

📝 Walkthrough

Walkthrough

Adds repository-local workflow skills and agent interfaces, a risk-scoped productivity planning engine, CLI commands for local checks and evidence, portable external workflow resolution, updated command wiring, and comprehensive planner and CLI tests.

Changes

Productivity workflow system

Layer / File(s) Summary
Skill contracts and repository integration
.agents/skills/*, AGENTS.md, .gitignore
Adds documented workflow skills, agent metadata, repository usage guidance, and ignore rules exposing skills while restricting plugin artifacts.
Risk classification and plan construction
scripts/productivity-core.mjs, scripts/ci-change-scope.mjs
Classifies changed paths, builds local and approval-required plans, analyzes failures and operator backlog, executes local checks, writes evidence, and expands workflow-scope detection.
CLI and command wiring
scripts/productivity-workflow.mjs, scripts/external-workflow.mjs, package.json, docs/productivity-workflows.md
Adds workflow planning commands, evidence and JSON output, external workflow discovery through configured roots or Git common directories, and documentation of safe execution semantics.
Planner and portability validation
tests/productivity-workflow.test.ts
Tests risk classification, provider-command exclusion, workflow-specific gates, CLI validation, evidence output, failure analysis, operator extraction, and external workflow portability.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Operator
  participant productivity-workflow
  participant productivity-core
  participant ci-change-scope
  Operator->>productivity-workflow: Select workflow and options
  productivity-workflow->>productivity-core: Build scoped workflow plan
  productivity-core->>ci-change-scope: Read changed-file scope
  ci-change-scope-->>productivity-core: Return risk flags
  productivity-core-->>productivity-workflow: Return local checks and approval gates
  productivity-workflow-->>Operator: Render plan or run local checks
Loading

Possibly related PRs

Suggested labels: codex

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly summarizes the main change: adding the Database skills catalog and workflows skill.
Description check ✅ Passed The description matches the template well with Summary, Verification, and Risk/rollback sections; no required content is materially missing for this docs-only change.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/chat-ensure-unique-tree-pr-94f3

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Biome (2.5.3)
scripts/ci-change-scope.mjs

File contains syntax errors that prevent linting: Line 76: Expected an expression for the left hand side of the << operator.; Line 76: Expected an expression but instead found '<<'.; Line 76: Expected an expression but instead found '<<'.; Line 77: expected > but instead found ^; Line 77: unexpected token \; Line 77: expected ) but instead found ?; Line 77: Expected an expression, or an assignment but instead found ':'.; Line 77: expected , but instead found ); Line 77: unexpected token \; Line 79: unexpected token \; Line 79: unexpected token \

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

scripts/ci-change-scope.mjs

Parsing error: Merge conflict marker encountered.


Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@scripts/productivity-core.mjs`:
- Around line 28-33: Extend the clinical classification matcher in the clinical
array to include src/lib/ranking*.ts changes, ensuring approvalChecks() applies
the production-readiness gate to ranking-only modifications. Add a regression
test covering a change limited to a ranking file and verify it is classified as
clinical.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: c1fc65b7-49db-465f-b961-2edb4da18db1

📥 Commits

Reviewing files that changed from the base of the PR and between b45f095 and d22a989.

📒 Files selected for processing (27)
  • .agents/skills/clinical-change-proof/SKILL.md
  • .agents/skills/clinical-change-proof/agents/openai.yaml
  • .agents/skills/database-flightplan/SKILL.md
  • .agents/skills/database-flightplan/agents/openai.yaml
  • .agents/skills/database-skills.md
  • .agents/skills/live-design-sweep/SKILL.md
  • .agents/skills/live-design-sweep/agents/openai.yaml
  • .agents/skills/operator-closeout/SKILL.md
  • .agents/skills/operator-closeout/agents/openai.yaml
  • .agents/skills/rag-change-lab/SKILL.md
  • .agents/skills/rag-change-lab/agents/openai.yaml
  • .agents/skills/session-lifecycle/SKILL.md
  • .agents/skills/session-lifecycle/agents/openai.yaml
  • .agents/skills/verify-triage-fix/SKILL.md
  • .agents/skills/verify-triage-fix/agents/openai.yaml
  • .agents/skills/workflows/SKILL.md
  • .agents/skills/workflows/agents/openai.yaml
  • .gitignore
  • AGENTS.md
  • docs/branch-review-ledger.md
  • docs/productivity-workflows.md
  • package.json
  • scripts/ci-change-scope.mjs
  • scripts/external-workflow.mjs
  • scripts/productivity-core.mjs
  • scripts/productivity-workflow.mjs
  • tests/productivity-workflow.test.ts

Comment on lines +28 to +33
clinical: [
/^src\/app\/api\/(?:answer|differentials|documents|ingestion|medications|registry|search)/,
/^src\/lib\/(?:rag|retrieval|clinical|answer|citation|evidence|source|owner-scope|query-privacy)/,
/^supabase\//,
/^docs\/(?:clinical-governance|privacy-impact|samd-|source-governance)/,
],

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Classify ranking changes as clinical to preserve the production-readiness gate.

src/lib/ranking*.ts is retrieval-only, so approvalChecks() omits npm run check:production-readiness, contrary to AGENTS.md Line 313. Extend this matcher and add a ranking-only regression test.

Proposed fix
   clinical: [
     /^src\/app\/api\/(?:answer|differentials|documents|ingestion|medications|registry|search)/,
-    /^src\/lib\/(?:rag|retrieval|clinical|answer|citation|evidence|source|owner-scope|query-privacy)/,
+    /^src\/lib\/(?:rag|retrieval|ranking|clinical|answer|citation|evidence|source|owner-scope|query-privacy)/,
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
clinical: [
/^src\/app\/api\/(?:answer|differentials|documents|ingestion|medications|registry|search)/,
/^src\/lib\/(?:rag|retrieval|clinical|answer|citation|evidence|source|owner-scope|query-privacy)/,
/^supabase\//,
/^docs\/(?:clinical-governance|privacy-impact|samd-|source-governance)/,
],
clinical: [
/^src\/app\/api\/(?:answer|differentials|documents|ingestion|medications|registry|search)/,
/^src\/lib\/(?:rag|retrieval|ranking|clinical|answer|citation|evidence|source|owner-scope|query-privacy)/,
/^supabase\//,
/^docs\/(?:clinical-governance|privacy-impact|samd-|source-governance)/,
],
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@scripts/productivity-core.mjs` around lines 28 - 33, Extend the clinical
classification matcher in the clinical array to include src/lib/ranking*.ts
changes, ensuring approvalChecks() applies the production-readiness gate to
ranking-only modifications. Add a regression test covering a change limited to a
ranking file and verify it is classified as clinical.

@BigSimmo

Copy link
Copy Markdown
Owner Author

@copilot resolve the merge conflicts on this branch.

auto-merge was automatically disabled July 18, 2026 12:37

Head branch was pushed to by a user without write access

Copilot AI commented Jul 18, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts on this branch.

Merge conflicts resolved in commit fix: resolve merge conflict markers. Two files had conflicts:

  • scripts/ci-change-scope.mjs: took origin/main's version which adds ci-triage and pr-policy to the workflow script pattern.
  • docs/branch-review-ledger.md: took origin/main's version which is a superset containing all ledger entries from both sides.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants