Skip to content

[codex] Add implementation review workflow#1251

Draft
defin85 wants to merge 1 commit into
Fission-AI:mainfrom
defin85:codex/add-review-impl-vs-plan-workflow
Draft

[codex] Add implementation review workflow#1251
defin85 wants to merge 1 commit into
Fission-AI:mainfrom
defin85:codex/add-review-impl-vs-plan-workflow

Conversation

@defin85

@defin85 defin85 commented Jun 24, 2026

Copy link
Copy Markdown

Summary

  • add an optional review workflow exposed as /opsx:review and openspec-review-impl-vs-plan
  • register the workflow in skill/command generation, profile selection, and profile drift detection
  • document the command and update generated workflow lists/spec expectations

Why

/opsx:verify is useful for archive readiness, but mature brownfield projects often need a stricter read-only implementation review that traces plan items to actual code, default runtime wiring, tests, config, examples, and docs before accepting a change as implemented.

Validation

  • pnpm exec vitest run test/core/profiles.test.ts test/core/shared/skill-generation.test.ts test/core/templates/skill-templates-parity.test.ts test/commands/config-profile.test.ts test/commands/config.test.ts
  • pnpm run build
  • pnpm run lint (passes with an existing warning in src/core/references.ts)
  • node bin/openspec.js validate --specs --no-interactive

Generated with Codex using GPT-5.

@coderabbitai

coderabbitai Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 72cfc49e-f4e7-49ee-95d7-89f2276e2b01

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

clay-good added a commit to clay-good/OpenSpec that referenced this pull request Jun 29, 2026
…sign

After a comprehensive sweep of open issues, PRs, and discussions, grounded the
proposal in the complete adjacent landscape and answered the open design
questions the cluster raises:

- Fission-AI#783 (Cross-artifact quality review before apply) is now a primary Closes:
  it IS audit mode. Answer its open "new skill vs. extend validate" question via
  the determinism split — deterministic checks (drift/completeness/coverage) are
  CLI/validate-shaped; the semantic cross-artifact review is the skill. Added a
  skill spec scenario for the Fission-AI#783 patterns (scope contradiction, spec gap,
  duplication).
- Discussion Fission-AI#1206 ("refine proposal now?") + prior-art PR Fission-AI#372: official answer
  is /opsx:update.
- New design Decision 8 (command family): delineate /opsx:update from
  /opsx:clarify (Fission-AI#702, within-artifact), /opsx:review (Fission-AI#1251, plan-vs-code), and
  verify; /opsx:update consolidates update+regen+refine into one action,
  addressing skill-sprawl (Fission-AI#1263, Fission-AI#783).
- Reuse, don't reinvent: audit's empty/incomplete check reuses Fission-AI#1098's
  artifactOutputComplete (same outputs.ts the digest helper lives in); capability
  coverage reuses Fission-AI#1277's validateChangeCapabilityCoverage.
- New open questions: surface deterministic coherence in `validate` for a CI gate
  (Fission-AI#783-B, Fission-AI#829); naming reconciliation with Fission-AI#783's /opsx:refine.
- Confirmed add-update-command* branches are the `openspec update` tool-file
  refresh (not artifact update) — no collision.

Validates clean under --strict; 10 deltas; all relative links resolve.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
clay-good added a commit to clay-good/OpenSpec that referenced this pull request Jun 29, 2026
…ission-AI#880

Grounded the surface so an implementer builds it without guessing, and added
proportionate forward-compatibility:

- New design "Data contracts" section with exact shapes: extended ArtifactStatus
  (requires/dependents/digest/drift/driftFrom — additive to the real interface at
  instruction-loader.ts:120), the --impact response, and the `.openspec.yaml`
  baselines ledger. All additive; nothing existing changes type.
- Digest scheme tag (`sha256-relpath-v1:`) + forward-compat: drift compares only
  same-scheme digests; an unrecognized/older scheme reports `unknown` rather than
  silently mis-comparing — re-reconcile restores it. Added a cli spec scenario
  and tasks for it.
- Grounded the ledger write: there is no central change-metadata writer today
  (change-metadata/index.ts only re-exports schema), so reconcile does a safe
  read-modify-write of .openspec.yaml mirroring the store's
  parse/serialize/writeStoreMetadataState pattern (foundation.ts).
- Coverage: re-swept; folded Fission-AI#880 (/opsx:validate code-vs-living-specs) into the
  plan-vs-code delineation alongside Fission-AI#1251/Fission-AI#1073. Main unchanged (546224e); all
  citations still valid.

Validates clean under --strict; 10 deltas; links resolve.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant