Skip to content

chore: reposition modules roadmap around validation#316

Merged
djm81 merged 5 commits into
mainfrom
dev
Jun 6, 2026
Merged

chore: reposition modules roadmap around validation#316
djm81 merged 5 commits into
mainfrom
dev

Conversation

@djm81

@djm81 djm81 commented Jun 6, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Reposition the modules OpenSpec roadmap around SpecFact as the validation and AI-bloat defense tool.
  • Archive completed/closed AI-bloat, simplification, cleanup forecast, docs guardrail, tester reliability, project/runtime, prompt-contract, marketplace, and codebase hardening changes.
  • Park Scrum/Kanban/SAFe/ceremony expansions unless they directly support validation evidence.
  • Rewrite active runtime/context-adapter proposals around validation evidence, upstream inputs, and AI IDE remediation handoff.

Validation

  • hatch run openspec validate --all --strict
  • hatch run yaml-lint
  • hatch run python scripts/pre_commit_code_review.py openspec/changes openspec/CHANGE_ORDER.md openspec/parking-lot/README.md

Note: the code-review wrapper skipped because this is an OpenSpec/docs-only change with no staged Python targets.

Governance Notes

Project-board metadata still needs recheck with a token that has project-field access before scoped implementation starts.

@djm81 djm81 self-assigned this Jun 6, 2026
@djm81 djm81 added the architecture Architecture-related topic label Jun 6, 2026
@strix-security

strix-security Bot commented Jun 6, 2026

Copy link
Copy Markdown

Strix is installed on this repository, but we could not run this PR security review because this workspace does not have an active plan. If you'd like to continue receiving code reviews, you can add a payment method or manage billing here.

@djm81 djm81 added documentation Improvements or additions to documentation change-proposal Proposal for a new change labels Jun 6, 2026
@coderabbitai

coderabbitai Bot commented Jun 6, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 9ce30231-e0d4-40f6-83a3-8930ac7f0f03

📥 Commits

Reviewing files that changed from the base of the PR and between 0cd0530 and a624b13.

📒 Files selected for processing (13)
  • openspec/specs/ai-ide-remediation-handoff/spec.md
  • openspec/specs/backlog-sync/spec.md
  • openspec/specs/bundle-packaged-resources/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/module-command-overview/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/prompt-command-validation/spec.md
  • openspec/specs/review-finding-model/spec.md
  • openspec/specs/review-run-command/spec.md

📝 Walkthrough

OpenSpec Roadmap Repositioning: Validation-First Focus

This documentation-only PR recenters the modules-side OpenSpec roadmap around SpecFact as the validation and AI‑bloat defense tool. It reorganizes planning into Status Snapshot / Tracks / Waves, archives completed validation work, parks non-validation expansions, and rewrites active runtime/context-adapter proposals to emphasize producing validation evidence and AI‑IDE remediation handoffs. No code, manifests, package versions, or exported APIs are modified.

Bundle and module surface

  • Commands/adapters: No new runtime commands shipped by this PR; proposals reframe module-owned runtime behaviors (validation runtimes, context adapters, evidence import sidecars) to focus on evidence emission and handoff rather than authoring or lifecycle orchestration.
  • Bridge/runtime vs specfact-cli APIs: Active proposals explicitly retain module-side runtime/adapters while preserving core-owned validation contracts and evidence envelope semantics; several proposals rename capabilities to runtime-focused names (e.g., validation-evidence-graph-runtime, architecture-boundary-validation-runtime, openspec-speckit-evidence-import-runtime) and document expected CLI behavior (evidence dirs, --preview-fixes, --with-mutation).
  • AI IDE remediation: Adds a new ai-ide-remediation-handoff spec defining a machine-readable remediation packet contract (guidance_kind, cleanup_forecast, remediation_packet) for IDE/assistant handoffs.

Manifest and integrity

  • No module-package.yaml or semver changes in this PR; manifest/command surfaces and bundle dependencies remain unchanged.
  • CI / signing / manifest semantics: Specs refine CI signing/scoping and module manifest handling (ci-module-signing-on-approval, ci-integration) but these are documentation/spec changes only—no registry or signature artifacts are modified by this PR.
  • Runtime artifact safety and merge semantics: New specs define safe-write and merge behavior for .specfact and bundle-owned resources to avoid silent overwrites (runtime-artifact-write-safety, bundle-packaged-resources, resource-aware-integrity).

Cross-repo (core specfact-cli) implications

  • Core counterpart linking updated across active proposals (examples: governance-01 → core #247, traceability-01 → core #242, validation-02 → core #241, requirements proposals → core #239/chore(registry): publish changed modules #244, architecture → core #237, openspec intent-trace → core #168/350). These are coordination notes — they do not change core code in this PR.
  • Contract alignment: Documents narrow module scope to import/validate and emit evidence; they preserve and require alignment on core-owned evidence envelope schemas, severity/profile semantics, and policy contracts before implementation proceeds.
  • Dev-deps / import paths: No new dev-dependency or import-path assumptions introduced by this PR. Project-board metadata and some implementation tasks reference rechecks requiring tokens with project-field access before scoped implementation.

Docs, pages, and CHANGELOG

  • Docs coverage expanded: Many new/updated specs formalize documentation expectations (prompt command validation, modules docs publishing, bundle-overview pages, published-route link resolution, docs pre-commit parity). These tighten modules.specfact.io / GitHub Pages validation and require deterministic generated-route link resolution and doc-test coverage in CI.
  • CHANGE_ORDER and parking-lot: Replaces old change-order dependency tables with a Status Snapshot, Active/Parked/Archived lists, Implementation Waves, and explicit parking/un-park triggers; completed validation work moved to openspec/changes/archive and parked proposals to openspec/parking-lot.
  • CHANGELOG: The PR commit messages and CHANGE_ORDER document provide the documentation-level changelog for this repositioning; no automated CHANGELOG edits to module manifests are performed.

OpenSpec change IDs and scenario coverage (module-specific)

  • Active tracks/waves and key documents (examples):
    • Track A (Validation Runtime): governance-01-evidence-output, traceability-01-index-and-orphans, validation-02-full-chain-engine (reframed as validation evidence graph runtime)
    • Track B (Upstream Adapters): requirements-02-module-commands, requirements-03-backlog-sync, openspec-01-intent-trace, architecture-01-solution-layer (reframed to boundary validation)
    • Track C (Docs/Support): multiple docs/specs for publishing, prompt validation, command overviews, pre-commit parity
  • Scenario coverage added across specs for module CLI behavior, prompt validation, evidence emission (--evidence-dir), safe fix preview (--preview-fixes), mutation opt-in, simplification/guided-simplify flows, backlog default resolution, and safe bundle resource packaging.
  • Archive/Parked mechanics: Archive policy and restoration checklist added; un-parking requires concrete validation evidence triggers, passing openspec validate --strict, and core compatibility recheck.

Validation and implementation notes

  • Validation steps documented in PR: hatch run openspec validate --all --strict, hatch run yaml-lint, and the pre-commit code-review wrapper noted as skipped for this docs-only PR.
  • Implementation gating: Many proposals specify pre-implementation checklist items (project metadata recheck using appropriate tokens, evidence envelope compatibility with core) before changing code or manifests.

Overall impact summary

  • Effect: Reorganization and normalization of module-side planning/specs to a validation-first posture; extensive spec additions/edits to formalize evidence, remediation, docs, and safe runtime behavior.
  • Risk: Low for this PR (documentation-only). Subsequent implementation work will require careful cross-repo coordination with core to preserve evidence contract compatibility and CI/manifest signing semantics.

Walkthrough

Reframes OpenSpec planning into track/wave status, rewrites several module proposals toward runtime evidence/import/validation scopes, and adds many specification contracts for review findings, CLI behavior, docs validation, backlog safety, and safe runtime writes.

Changes

Roadmap & Planning

Layer / File(s) Summary
Change order status snapshot and track/wave ordering
openspec/CHANGE_ORDER.md
Replaced module-by-dependency tables with status snapshot, active tracks (Validation Runtime Spine, Upstream Context Adapters, Supporting Docs), Modify Queue, parked lists, implementation waves, parent-issue framing, and archive policy.
Parking lot policy and un-park criteria
openspec/parking-lot/README.md
Rewrote parking-lot README to "paused not abandoned", updated restoration policy and expanded un-park trigger matrix.

Module proposal scope rewrites (evidence/runtime framing)

Layer / File(s) Summary
Architecture boundary validation runtime
openspec/changes/architecture-01-solution-layer/proposal.md
Shifted architecture proposal to boundary-validation runtime: import ADR/contract records, validate ownership/interface/link integrity, removed AI-assisted generation/templating from critical path.
Governance runtime evidence output
openspec/changes/governance-01-evidence-output/proposal.md
Rewrote to runtime evidence writer: --evidence-dir .specfact/evidence/ persistence, CI-mode exit-code semantics, evidence envelope emission including ai_bloat results.
OpenSpec / Spec Kit evidence import runtime
openspec/changes/openspec-01-intent-trace/proposal.md
Reframed intent-trace as evidence import runtime with optional metadata parsing and careful source-attributed mapping.
Requirements import & validation runtime
openspec/changes/requirements-02-module-commands/proposal.md
Narrowed requirements module to import/normalize/validate upstream requirement context with bounded adapter return shapes and no interactive authoring.
Backlog requirement drift runtime
openspec/changes/requirements-03-backlog-sync/proposal.md
Replaced bidirectional sync with drift-detection runtime: read-first import, conflict preview, drift evidence emission, duplicate-creation safeguards.
Artifact evidence index & orphan detection runtime
openspec/changes/traceability-01-index-and-orphans/proposal.md
Reframed traceability as artifact-evidence-index-runtime with incremental orphan/drift detection and JSON export for downstream consumers.
Validation evidence graph runtime (design & tasks)
openspec/changes/validation-02-full-chain-engine/{proposal.md,design.md,tasks.md}
Validation-02 refocused to validation-evidence-graph-runtime: runtime graph builder/validators, governance-compatible evidence output, updated dependency set and guardrail tasks.

Code-review, simplification, and related specs

Layer / File(s) Summary
ReviewFinding schema and simplification metadata
openspec/specs/review-finding-model/spec.md
Restructured ReviewFinding into Purpose/Requirements, added optional simplification metadata fields, expanded categories/tools, and examples including ai_bloat advisory.
AI-bloat detection & policy pack
openspec/specs/code-review-ai-bloat-detection/spec.md
New ai_bloat finding-category, Semgrep rule-pack + AST runner detectors, advisory-only policy pack, and IDE simplify prompt workflow for ai_bloat findings.
Simplification-feedback and guided simplify specs
openspec/specs/code-review-simplification-feedback/spec.md, openspec/specs/guided-simplification-review/spec.md
New specs for simplification metadata, deterministic grouping by intent_key, advisory-only simplification findings, guidance_kind safety classes, and /specfact.08-simplify consumption/confirmation flow.
Cleanup forecast & AI-bloat metrics
openspec/specs/cleanup-forecast-review/spec.md
New cleanup forecast schema (reviewed_loc, low/expected/high deletion estimates, grouping by guidance_kind) and normalized AI-bloat index metrics with default weights.
AI IDE remediation handoff
openspec/specs/ai-ide-remediation-handoff/spec.md
New JSON remediation-packet contract for IDE handoff, ordering rules for assistants (simplify evidence first, sort by guidance_kind, inspect cleanup_forecast, apply remediation packet before edits).
Review-run command simplify behaviors
openspec/specs/review-run-command/spec.md
Extended review-run spec: --preview-fixes forecast-only, invalid combinations (--preview-fixes + --fix), --with-mutation limited to simplify mode, docs parity requirements, and enforce/fix semantics constrained to safe_mechanical guidance.

CLI, prompts, tool diagnostics

Layer / File(s) Summary
Module CLI error contract
openspec/specs/module-cli-error-contract/spec.md
New CLI error/help contract: actionable missing-subcommand help, kebab-case missing-option naming in help/errors, legacy invocation guidance, and typed diagnostics for bundle-data errors.
Module command overview generation
openspec/specs/module-command-overview/spec.md
New spec for deterministic command overview artifacts, required fields, README linking, and freshness checks.
Prompt command validation & gates
openspec/specs/prompt-command-validation/spec.md
New spec requiring prompt resources validate CLI command paths/options against mounted CLI tree, include CLI reality-check guidance, expose Hatch command and run in pre-commit/CI gates.
Tool dependency diagnostics
openspec/specs/code-review-tool-dependencies/spec.md
Tool availability probes must use active execution context (uv/hatch/pip/pipx) and emit installation hints matching detected manager context.

Backlog, project, import, and runtime write safety

Layer / File(s) Summary
Backlog add/delta/sync behaviors
openspec/specs/backlog-add/spec.md, openspec/specs/backlog-delta/spec.md, openspec/specs/backlog-sync/spec.md
Backlog commands must preserve unrelated .specfact settings on updates, resolve documented defaults from .specfact/backlog-config.yaml, and distinguish managed .specfact artifacts from external targets (no silent overwrites).
Project command surface
openspec/specs/project-command-surface/spec.md
New spec requiring specfact-project bundle exposes project and plan command groups in manifest and docs.
Codebase import runtime
openspec/specs/codebase-import-runtime/spec.md
New spec defining deterministic ignore-policy ordering, pruning of hidden/heavy directories, large-tree warnings, and progress reporting from discovered-vs-processed work.
Runtime artifact write safety
openspec/specs/runtime-artifact-write-safety/spec.md
New spec defining safe write semantics: .specfact vs external artifact ownership, preserve unrelated user-managed keys during merges, fail-safe behavior for unsupported shapes.

Docs publishing, packaged resources, and integrity gates

Layer / File(s) Summary
Bundle overview & published permalink link validation
openspec/specs/bundle-overview-pages/spec.md
New requirements: overview pages must use links resolving from published permalink routes and be covered by docs validation tests.
Modules docs command validation & front-matter enforcement
openspec/specs/modules-docs-command-validation/spec.md
Validate command examples against generated overview; require published-route link resolution, front-matter fields, stable finding categories, and docs build dependency health checks.
Packaged resources & generator templates
openspec/specs/bundle-packaged-resources/spec.md
Added Purpose and scenarios requiring bundles to ship module-owned non-code resources including Jinja2 templates; pre-release validation fails when template missing.
Docs publishing & pre-commit parity
openspec/specs/modules-docs-publishing/spec.md, openspec/specs/modules-pre-commit-quality-parity/spec.md
Docs publishing must install deps, run Jekyll build, validate generated-site routes before deploy; CI docs review and local pre-commit must share validators; docs-only PRs must run published-link validation.
Resource-aware integrity
openspec/specs/resource-aware-integrity/spec.md
Bundle integrity must include prompt command validation on prompt edits with local and CI gates reporting stale command paths/options.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related issues

Possibly related PRs

Focus notes (correctness/security/regressions): changes are documentation/spec-only; verify no code-level contract text was accidentally introduced as normative implementation detail; confirm references to issue numbers and artifact paths are accurate before downstream automation consumes these docs.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch dev

@djm81 djm81 moved this from Todo to In Progress in SpecFact CLI Jun 6, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 19cc5eb7e7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread openspec/specs/bundle-packaged-resources/spec.md
Comment thread openspec/specs/review-run-command/spec.md

@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: 11

🧹 Nitpick comments (1)
openspec/specs/review-run-command/spec.md (1)

176-176: 💤 Low value

Simplify the scenario prose and reduce implementation detail.

The scenario text includes bold-formatted type signatures and overly specific implementation details (e.g., run signature files: list[Path]). Spec scenarios should describe observable behavior and user-facing contracts, not internal type signatures. Consider rephrasing to focus on the user-facing distinction: "pass explicit file paths as positional arguments, or use --scope/--path flags for auto-discovery."

🤖 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 `@openspec/specs/review-run-command/spec.md` at line 176, The scenario prose is
too implementation-specific (mentions internal type signatures like files:
list[Path]); update the text to describe only the user-facing behavior: remove
the bold type signature and rephrase to say users can either pass explicit file
paths as positional arguments or use the --scope / --path flags to auto-discover
targets from the repo, keeping references to the run command and the flags
(--scope, --path) but omitting internal type details.
🤖 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 `@openspec/specs/ai-ide-remediation-handoff/spec.md`:
- Around line 3-4: Replace the placeholder "TBD" under the "## Purpose" header
with a concise purpose statement that clearly describes the spec's scope: define
the validation evidence handoff process for AI IDE remediation, including what
evidence is transferred, who the stakeholders are, handoff triggers, and success
criteria; locate the "## Purpose" section in the spec (the line starting with
"## Purpose") and update its content to reflect the validation evidence handoff
scope and intended outcomes.

In `@openspec/specs/backlog-sync/spec.md`:
- Around line 65-69: The phrase "MAY rewrite that managed artifact
deterministically" is contradictory; update the specification text for the
scenario that references `.specfact` to use a normative modal to express
consistent behavior (e.g., replace "MAY" with "SHALL" or "SHOULD" as
appropriate) so the contract is clear—modify the sentence in "Default managed
baseline state updates deterministically" replacing "MAY rewrite that managed
artifact deterministically" with "SHALL rewrite that managed artifact
deterministically" (or "SHOULD" if you want a softer mandate) and keep the rest
of the clause about treating it as SpecFact-managed state unchanged.

In `@openspec/specs/ci-integration/spec.md`:
- Line 47: The spec line is ambiguous about which workflow triggers the "re-sign
on pull_request synchronize" behavior; update the text to explicitly state that
this scenario is driven by the PR auto-sign workflow
(.github/workflows/sign-modules.yml) which runs on pull_request (synchronize)
and performs git push of signed manifests (and therefore must skip bot-authored
commits), and clarify that sign-modules-on-approval.yml only runs on
pull_request_review when the review is approved and is not the
synchronize-triggered signer.

In `@openspec/specs/ci-module-signing-on-approval/spec.md`:
- Line 17: The spec removed an important clarification about how the merge-base
for payload discovery is computed; restore a sentence clarifying that discovery
should be computed "since origin/dev" and not merely "divergent from the moving
`origin/dev` tip" (or else update the wording to unambiguously describe the new
intended merge-base computation), so update the text around the
merge-base/merge-base discovery wording (look for the paragraph referencing
merge-base or payload discovery) to reintroduce that exact behavioral
expectation or replace it with precise wording that matches the implementation.
- Line 14: Update openspec/specs/ci-module-signing-on-approval/spec.md to
explicitly define “trusted reviewer” to match the workflow gate in
.github/workflows/sign-modules-on-approval.yml (i.e., a reviewer whose
github.event.review.user.author_association is one of COLLABORATOR, MEMBER, or
OWNER and whose review state is approved, and include that this gate controls
access to SPECFACT_MODULE_PRIVATE_SIGN_KEY and
SPECFACT_MODULE_PRIVATE_SIGN_KEY_PASSPHRASE); also restore the archived
parenthetical clarification about “merge-base with origin/dev” (e.g., “not
merely divergent from the moving origin/dev tip”) so the spec’s merge-base
requirement cannot be misinterpreted.

In `@openspec/specs/code-review-ai-bloat-detection/spec.md`:
- Line 12: Update the category enumeration in the code-review pipeline spec to
include the new ai_bloat category: add `ai_bloat` alongside the existing values
listed on the line that currently reads `naming | kiss | yagni | dry | solid |
clean_code | architecture`, ensuring `.specfact/code-review.json` is updated via
an additive strict-schema change so `ReviewFinding.category` recognizes
`ai_bloat`; also document that `ai_bloat` is used as the policy-pack `principle`
for AI-bloat rules and that findings under `ai_bloat` must emit at `info`
severity only and remain score-neutral in v1.

In `@openspec/specs/code-review-simplification-feedback/spec.md`:
- Line 13: The review-finding-model lacks the simplification metadata fields
declared in code-review-simplification-feedback; update
openspec/specs/review-finding-model/spec.md to either (A) add the top-level
fields confidence, rewrite_hint, canonical_pattern, intent_key,
estimated_deletion_lines, related_locations into the Finding schema (matching
types and descriptions from code-review-simplification-feedback) or (B)
explicitly document the mapping that these fields are stored inside
remediation_packet (or another container), include the exact JSON shape/example
and update schema validation rules for Finding, and mention how these relate to
existing signal_trace, preserve_reasons and remediation_packet so
consumers/validators have a single consistent contract. Ensure you reference the
exact field names (confidence, rewrite_hint, canonical_pattern, intent_key,
estimated_deletion_lines, related_locations, signal_trace, preserve_reasons,
remediation_packet) and add or update schema examples and validation rules
accordingly.

In `@openspec/specs/guided-simplification-review/spec.md`:
- Line 21: Update the guided-simplification-review spec so that findings with
action "preserve" use the field name preserve_reasons (plural) instead of
preserve_reason, and reference the same closed taxonomy defined by
ReviewFinding.preserve_reasons in the review-finding-model spec; locate the
occurrence of preserve_reason in the guided-simplification-review spec and
replace it with preserve_reasons and add/point to the taxonomy enumeration used
by ReviewFinding.preserve_reasons to ensure both specs share the identical field
name and allowed values.

In `@openspec/specs/module-command-overview/spec.md`:
- Around line 3-4: Replace the placeholder "TBD" under the "## Purpose" heading
in the module-command-overview spec with a concise purpose statement that
describes this document as the canonical, deterministic definition of the
modules runtime command surface used for validation, tooling, and AI IDE
consumers; mention it supports generation of command-overview artifacts, enables
automated validation and reproducible documentation, and serves as the
authoritative input for IDE integrations and AI assistants that need a stable
command API.

In `@openspec/specs/modules-docs-publishing/spec.md`:
- Around line 68-77: Update the terminology to exactly match the formal defect
category name used in modules-pre-commit-quality-parity: replace the phrases
"published-route link validation" and "broken published-route link" with the
formal token `published-link` (including backticks) in the requirement/Scenario
text so the docs review CI wording exactly matches the local validator category.

In `@openspec/specs/prompt-command-validation/spec.md`:
- Around line 3-4: Replace the placeholder "TBD" under the "## Purpose" heading
with a concise Purpose statement that frames this spec as defining bundle prompt
validation against the mounted CLI contract to prevent drift between operational
guidance and shipped module behavior; explicitly state that the spec mandates
validating prompt-generated commands and flags against the mounted CLI contract
to ensure prompts remain consistent with the module's actual CLI surface and to
catch mismatches before release.

---

Nitpick comments:
In `@openspec/specs/review-run-command/spec.md`:
- Line 176: The scenario prose is too implementation-specific (mentions internal
type signatures like files: list[Path]); update the text to describe only the
user-facing behavior: remove the bold type signature and rephrase to say users
can either pass explicit file paths as positional arguments or use the --scope /
--path flags to auto-discover targets from the repo, keeping references to the
run command and the flags (--scope, --path) but omitting internal type details.
🪄 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

Run ID: 66dc94a2-06fb-470d-950f-f24533f67166

📥 Commits

Reviewing files that changed from the base of the PR and between be9c27f and 0cd0530.

📒 Files selected for processing (159)
  • openspec/CHANGE_ORDER.md
  • openspec/changes/architecture-01-solution-layer/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/.openspec.yaml
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/design.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/clean-code-analysis/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/code-review-simplification-feedback/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/review-finding-model/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/review-run-command/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/tasks.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/.openspec.yaml
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/design.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/specs/guided-simplification-review/spec.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/specs/review-finding-model/spec.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/specs/review-run-command/spec.md
  • openspec/changes/archive/2026-06-06-code-review-12-guided-simplification-enforcement/tasks.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/.openspec.yaml
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/README.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/design.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/specs/ai-ide-remediation-handoff/spec.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/specs/cleanup-forecast-review/spec.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/specs/review-finding-model/spec.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/specs/review-run-command/spec.md
  • openspec/changes/archive/2026-06-06-code-review-13-cleanup-forecast-agent-handoff/tasks.md
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/design.md
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/specs/code-review-ai-bloat-detection/spec.md
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/tasks.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/.openspec.yaml
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/design.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/proposal.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/specs/bundle-packaged-resources/spec.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/specs/codebase-import-runtime/spec.md
  • openspec/changes/archive/2026-06-06-codebase-import-runtime-hardening/tasks.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/.openspec.yaml
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/design.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/proposal.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/bundle-overview-pages/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-command-validation/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-publishing/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/tasks.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/.openspec.yaml
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/design.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/proposal.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/specs/ci-integration/spec.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/specs/ci-module-signing-on-approval/spec.md
  • openspec/changes/archive/2026-06-06-marketplace-07-pr-auto-sign-updates/tasks.md
  • openspec/changes/archive/2026-06-06-project-02-plan-root-command-fix/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-project-02-plan-root-command-fix/design.md
  • openspec/changes/archive/2026-06-06-project-02-plan-root-command-fix/proposal.md
  • openspec/changes/archive/2026-06-06-project-02-plan-root-command-fix/specs/project-command-surface/spec.md
  • openspec/changes/archive/2026-06-06-project-02-plan-root-command-fix/tasks.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/.openspec.yaml
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/CHANGE_VALIDATION.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/design.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/proposal.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/specs/backlog-add/spec.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/specs/backlog-sync/spec.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/specs/runtime-artifact-write-safety/spec.md
  • openspec/changes/archive/2026-06-06-project-runtime-01-safe-artifact-write-policy/tasks.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/.openspec.yaml
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/design.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/proposal.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/specs/bundle-packaged-resources/spec.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/specs/prompt-command-validation/spec.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/specs/resource-aware-integrity/spec.md
  • openspec/changes/archive/2026-06-06-prompt-command-contract-validation/tasks.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/.openspec.yaml
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/TDD_EVIDENCE.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/proposal.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/backlog-delta/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/code-review-tool-dependencies/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/module-cli-error-contract/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/module-command-overview/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/modules-docs-command-validation/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/tasks.md
  • openspec/changes/governance-01-evidence-output/proposal.md
  • openspec/changes/openspec-01-intent-trace/proposal.md
  • openspec/changes/requirements-02-module-commands/proposal.md
  • openspec/changes/requirements-03-backlog-sync/proposal.md
  • openspec/changes/traceability-01-index-and-orphans/proposal.md
  • openspec/changes/validation-02-full-chain-engine/design.md
  • openspec/changes/validation-02-full-chain-engine/proposal.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
  • openspec/parking-lot/README.md
  • openspec/parking-lot/backlog-kanban-01-flow-metrics/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-kanban-01-flow-metrics/proposal.md
  • openspec/parking-lot/backlog-kanban-01-flow-metrics/specs/kanban-flow/spec.md
  • openspec/parking-lot/backlog-kanban-01-flow-metrics/tasks.md
  • openspec/parking-lot/backlog-safe-01-pi-planning/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-safe-01-pi-planning/proposal.md
  • openspec/parking-lot/backlog-safe-01-pi-planning/specs/safe-pi/spec.md
  • openspec/parking-lot/backlog-safe-01-pi-planning/tasks.md
  • openspec/parking-lot/backlog-safe-02-risk-rollups/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-safe-02-risk-rollups/proposal.md
  • openspec/parking-lot/backlog-safe-02-risk-rollups/specs/risk-rollups/spec.md
  • openspec/parking-lot/backlog-safe-02-risk-rollups/tasks.md
  • openspec/parking-lot/backlog-scrum-02-sprint-planning/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-scrum-02-sprint-planning/design.md
  • openspec/parking-lot/backlog-scrum-02-sprint-planning/proposal.md
  • openspec/parking-lot/backlog-scrum-02-sprint-planning/specs/sprint-planning/spec.md
  • openspec/parking-lot/backlog-scrum-02-sprint-planning/tasks.md
  • openspec/parking-lot/backlog-scrum-03-story-complexity/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-scrum-03-story-complexity/design.md
  • openspec/parking-lot/backlog-scrum-03-story-complexity/proposal.md
  • openspec/parking-lot/backlog-scrum-03-story-complexity/specs/story-complexity/spec.md
  • openspec/parking-lot/backlog-scrum-03-story-complexity/tasks.md
  • openspec/parking-lot/backlog-scrum-04-definition-of-done/CHANGE_VALIDATION.md
  • openspec/parking-lot/backlog-scrum-04-definition-of-done/design.md
  • openspec/parking-lot/backlog-scrum-04-definition-of-done/proposal.md
  • openspec/parking-lot/backlog-scrum-04-definition-of-done/specs/definition-of-done/spec.md
  • openspec/parking-lot/backlog-scrum-04-definition-of-done/tasks.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/.openspec.yaml
  • openspec/parking-lot/ceremony-02-requirements-aware-output/CHANGE_VALIDATION.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/design.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/proposal.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/specs/backlog-refinement/spec.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/specs/ceremony-requirements-awareness/spec.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/specs/daily-standup/spec.md
  • openspec/parking-lot/ceremony-02-requirements-aware-output/tasks.md
  • openspec/specs/ai-ide-remediation-handoff/spec.md
  • openspec/specs/backlog-add/spec.md
  • openspec/specs/backlog-delta/spec.md
  • openspec/specs/backlog-sync/spec.md
  • openspec/specs/bundle-overview-pages/spec.md
  • openspec/specs/bundle-packaged-resources/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/cleanup-forecast-review/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/code-review-tool-dependencies/spec.md
  • openspec/specs/codebase-import-runtime/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/module-cli-error-contract/spec.md
  • openspec/specs/module-command-overview/spec.md
  • openspec/specs/modules-docs-command-validation/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/project-command-surface/spec.md
  • openspec/specs/prompt-command-validation/spec.md
  • openspec/specs/resource-aware-integrity/spec.md
  • openspec/specs/review-finding-model/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/runtime-artifact-write-safety/spec.md
💤 Files with no reviewable changes (1)
  • openspec/changes/archive/2026-06-06-code-review-ai-bloat-detection/specs/code-review-ai-bloat-detection/spec.md
📜 Review details
🧰 Additional context used
📓 Path-based instructions (1)
openspec/**/*.md

⚙️ CodeRabbit configuration file

openspec/**/*.md: Specification truth: proposal/tasks/spec deltas vs. bundle behavior, CHANGE_ORDER, and
drift vs. shipped modules or docs.

Files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-publishing/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/code-review-tool-dependencies/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/bundle-overview-pages/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/modules-docs-command-validation/spec.md
  • openspec/specs/backlog-add/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/backlog-delta/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/bundle-packaged-resources/spec.md
  • openspec/specs/codebase-import-runtime/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/ai-ide-remediation-handoff/spec.md
  • openspec/changes/governance-01-evidence-output/proposal.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/module-command-overview/spec.md
  • openspec/specs/cleanup-forecast-review/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/backlog-delta/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-command-validation/spec.md
  • openspec/specs/module-cli-error-contract/spec.md
  • openspec/specs/runtime-artifact-write-safety/spec.md
  • openspec/specs/code-review-tool-dependencies/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/project-command-surface/spec.md
  • openspec/specs/backlog-sync/spec.md
  • openspec/changes/validation-02-full-chain-engine/design.md
  • openspec/specs/resource-aware-integrity/spec.md
  • openspec/CHANGE_ORDER.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/clean-code-analysis/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/changes/requirements-03-backlog-sync/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/prompt-command-validation/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
  • openspec/changes/requirements-02-module-commands/proposal.md
  • openspec/specs/modules-docs-command-validation/spec.md
  • openspec/changes/openspec-01-intent-trace/proposal.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
  • openspec/parking-lot/README.md
  • openspec/changes/validation-02-full-chain-engine/proposal.md
  • openspec/changes/architecture-01-solution-layer/proposal.md
  • openspec/changes/traceability-01-index-and-orphans/proposal.md
  • openspec/specs/review-finding-model/spec.md
  • openspec/specs/bundle-overview-pages/spec.md
🧠 Learnings (19)
📓 Common learnings
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-04-13T10:38:29.399Z
Learning: When a change is paired with work in specfact-cli, review the paired public change artifacts there before widening scope or redefining shared workflow semantics
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Perform `spec -> tests -> failing evidence -> code -> passing evidence` in that order for behavior changes
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Finalize completed OpenSpec changes with `openspec archive <change-id>` and do not manually move change folders under `openspec/changes/archive/`
📚 Learning: 2026-04-02T21:49:11.371Z
Learnt from: djm81
Repo: nold-ai/specfact-cli-modules PR: 136
File: registry/modules/specfact-spec-0.40.17.tar.gz.sha256:1-1
Timestamp: 2026-04-02T21:49:11.371Z
Learning: In nold-ai/specfact-cli-modules, module tarball signatures (registry/signatures/*.tar.sig) are generated by the `publish-modules` GitHub Actions runner during the publish workflow, not committed locally to the branch. Missing signature files should NOT be flagged as a pre-merge blocker in PRs.

Applied to files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-publishing/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/module-command-overview/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
📚 Learning: 2026-04-13T10:38:29.399Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-04-13T10:38:29.399Z
Learning: When a change is paired with work in specfact-cli, review the paired public change artifacts there before widening scope or redefining shared workflow semantics

Applied to files:

  • openspec/specs/backlog-add/spec.md
  • openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/backlog-delta/spec.md
  • openspec/specs/codebase-import-runtime/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/ai-ide-remediation-handoff/spec.md
  • openspec/changes/governance-01-evidence-output/proposal.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/backlog-delta/spec.md
  • openspec/specs/runtime-artifact-write-safety/spec.md
  • openspec/specs/code-review-tool-dependencies/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/project-command-surface/spec.md
  • openspec/specs/backlog-sync/spec.md
  • openspec/changes/validation-02-full-chain-engine/design.md
  • openspec/CHANGE_ORDER.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/changes/requirements-03-backlog-sync/proposal.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
  • openspec/changes/openspec-01-intent-trace/proposal.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
  • openspec/changes/architecture-01-solution-layer/proposal.md
  • openspec/changes/traceability-01-index-and-orphans/proposal.md
  • openspec/specs/review-finding-model/spec.md
📚 Learning: 2026-04-13T10:38:15.855Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: .cursorrules:0-0
Timestamp: 2026-04-13T10:38:15.855Z
Learning: Adhere to worktree policy, OpenSpec gating, GitHub hierarchy-cache refresh, TDD order, quality gates, versioning, and documentation rules as defined in `docs/agent-rules/`

Applied to files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
📚 Learning: 2026-04-13T10:38:29.399Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-04-13T10:38:29.399Z
Learning: Treat canonical rule docs (docs/agent-rules/INDEX.md) as the source of truth for worktree policy, OpenSpec gating, GitHub completeness checks, TDD order, quality gates, versioning, and documentation rules

Applied to files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/modules-docs-command-validation/spec.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Treat the clean-code compliance gate as mandatory: the review surface enforces `naming`, `kiss`, `yagni`, `dry`, and `solid` categories and blocks regressions

Applied to files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md
  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/clean-code-analysis/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/code-review-simplification-feedback/spec.md
📚 Learning: 2026-04-13T10:38:22.848Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: .github/copilot-instructions.md:0-0
Timestamp: 2026-04-13T10:38:22.848Z
Learning: This repository enforces the clean-code review gate through hatch run specfact code review run --json --out .specfact/code-review.json

Applied to files:

  • openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md
  • openspec/specs/ai-ide-remediation-handoff/spec.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/cleanup-forecast-review/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
  • openspec/specs/review-finding-model/spec.md
📚 Learning: 2026-04-13T10:38:22.848Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: .github/copilot-instructions.md:0-0
Timestamp: 2026-04-13T10:38:22.848Z
Learning: Signed module or manifest changes require version-bump review and verify-modules-signature

Applied to files:

  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/modules-docs-publishing/spec.md
  • openspec/specs/resource-aware-integrity/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
📚 Learning: 2026-04-13T10:38:29.399Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-04-13T10:38:29.399Z
Learning: Applies to **/*.{js,ts,tsx,jsx,py,java,cs,go,rb,php,cpp,c,h} : Preserve the clean-code compliance gate and its category references (naming, kiss, yagni, dry, and solid)

Applied to files:

  • openspec/specs/modules-pre-commit-quality-parity/spec.md
  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/review-finding-model/spec.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Perform `spec -> tests -> failing evidence -> code -> passing evidence` in that order for behavior changes

Applied to files:

  • openspec/changes/governance-01-evidence-output/proposal.md
  • openspec/changes/validation-02-full-chain-engine/tasks.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Fix SpecFact code review findings, including warnings, unless a rare explicit exception is documented

Applied to files:

  • openspec/specs/clean-code-analysis/spec.md
  • openspec/specs/guided-simplification-review/spec.md
  • openspec/specs/code-review-ai-bloat-detection/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/review-run-command/spec.md
  • openspec/specs/code-review-simplification-feedback/spec.md
  • openspec/specs/review-finding-model/spec.md
📚 Learning: 2026-04-13T10:38:29.399Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-04-13T10:38:29.399Z
Learning: Treat clean-code regressions (naming, kiss, yagni, dry, solid violations) as blocking until they are fixed or explicitly justified

Applied to files:

  • openspec/specs/clean-code-analysis/spec.md
  • openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/clean-code-analysis/spec.md
📚 Learning: 2026-04-13T10:38:22.848Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: .github/copilot-instructions.md:0-0
Timestamp: 2026-04-13T10:38:22.848Z
Learning: Refresh .specfact/backlog/github_hierarchy_cache.md with python scripts/sync_github_hierarchy_cache.py when GitHub hierarchy metadata is missing or stale before parent or blocker work

Applied to files:

  • openspec/specs/backlog-sync/spec.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: If GitHub hierarchy metadata is needed and `.specfact/backlog/github_hierarchy_cache.md` is missing or stale, refresh it with `python scripts/sync_github_hierarchy_cache.py`

Applied to files:

  • openspec/specs/backlog-sync/spec.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Enforce module signatures and version bumps when signed module assets or manifests are affected

Applied to files:

  • openspec/specs/resource-aware-integrity/spec.md
  • openspec/specs/ci-integration/spec.md
  • openspec/specs/ci-module-signing-on-approval/spec.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Finalize completed OpenSpec changes with `openspec archive <change-id>` and do not manually move change folders under `openspec/changes/archive/`

Applied to files:

  • openspec/CHANGE_ORDER.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Require public GitHub metadata completeness before implementation when linked issue workflow applies: parent, labels, project assignment, blockers, and blocked-by relationships

Applied to files:

  • openspec/changes/validation-02-full-chain-engine/tasks.md
📚 Learning: 2026-04-13T10:38:22.848Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: .github/copilot-instructions.md:0-0
Timestamp: 2026-04-13T10:38:22.848Z
Learning: Work belongs on feature/*, bugfix/*, hotfix/*, or chore/* branches, normally in a worktree rooted under ../specfact-cli-modules-worktrees/

Applied to files:

  • openspec/changes/validation-02-full-chain-engine/tasks.md
📚 Learning: 2026-04-13T10:38:43.535Z
Learnt from: CR
Repo: nold-ai/specfact-cli-modules PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-04-13T10:38:43.535Z
Learning: Run the required verification and quality gates for the touched scope before finalization

Applied to files:

  • openspec/changes/validation-02-full-chain-engine/tasks.md
🪛 LanguageTool
openspec/changes/governance-01-evidence-output/proposal.md

[style] ~22-~22: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...dling based on profile/policy mode. - NEW: Evidence artifact naming and termina...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

openspec/changes/requirements-02-module-commands/proposal.md

[style] ~24-~24: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...for evidence usefulness by profile. - NEW: Adapter hooks return bounded records...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

openspec/specs/review-finding-model/spec.md

[style] ~14-~14: The double modal “required governed” is nonstandard (only accepted in certain dialects). Consider “to be governed”.
Context: ...HEN** the payload includes the required governed fields - AND category, severity, to...

(NEEDS_FIXED)

🔀 Multi-repo context nold-ai/specfact-cli

nold-ai/specfact-cli

  • CHANGE_ORDER and roadmap coordination

    • openspec/CHANGE_ORDER.md is referenced across many openspec change documents and cross-repo alignment analysis; multiple change/task files update or require CHANGE_ORDER.md updates (e.g. openspec/changes/* tasks.md files). [::nold-ai/specfact-cli::openspec/** tasks and analysis references]
  • Evidence / governance contracts referenced

    • openspec/changes/validation-02-full-chain-engine/CHANGE_VALIDATION.md mentions "governance evidence envelope; policy/profile severity consumers". [::nold-ai/specfact-cli::openspec/changes/validation-02-full-chain-engine/CHANGE_VALIDATION.md]
    • Cross-change analysis notes governance-01-evidence-output as owning evidence envelope and being split/rescope (openspec/changes/archive and analysis files). [::nold-ai/specfact-cli::openspec/changes/archive/* and openspec/changes/*/analysis.md]
  • AI-bloat / simplification consumers and tests

    • Tests and metadata reference ai_bloat / ai-bloat (pyproject.toml, docs/tests, unit tests): pyproject.toml includes "ai-bloat"; unit/docs tests reference ai-bloat docs pages and CI artifacts (tests/unit/docs/test_first_contact_story.py, tests/unit/scripts/test_code_review_module_docs.py). [::nold-ai/specfact-cli::pyproject.toml; tests/unit/docs/test_first_contact_story.py; tests/unit/scripts/test_code_review_module_docs.py]
    • Design/spec docs explicitly mention ai_bloat defense and simplify workflows (multiple openspec change/spec files, e.g. openspec/changes/archive/.../design.md and specs). [::nold-ai/specfact-cli::openspec/changes/archive/** and openspec/specs/**]
  • Runtime evidence/validation mentions in repo

    • Multiple openspec proposals/specs now talk about "validation evidence graph/runtime", "--evidence-dir", validation-evidence outputs, and sidecar evidence writers (search hits under openspec/changes/* and specs). These indicate the repo contains owners/consumers of the evidence output contract. [::nold-ai/specfact-cli::openspec/changes/* and openspec/specs/* mentioning evidence/runtime/--evidence-dir]
  • Cross-repo coordination signals

    • Several openspec analysis/design files explicitly call out the need to update or sync CHANGE_ORDER.md and planning inventories across specfact-cli and specfact-cli-modules (cross-repo ownership/change-order alignment). [::nold-ai/specfact-cli::openspec/changes/archive/* and openspec/changes/*/analysis.md]

Assessment

  • The PR (modules roadmap/docs-only) touches OpenSpec planning that is widely referenced in this repository (evidence/governance, ai-bloat/simplify, CHANGE_ORDER). There are direct references to governance-01 evidence envelope and ai_bloat/simplification flows in tests and specs here, so the modules repo changes are relevant and should be coordinated with specfact-cli's evidence/governance and docs/test expectations.
🔇 Additional comments (42)
openspec/CHANGE_ORDER.md (1)

1-159: LGTM!

openspec/parking-lot/README.md (1)

1-60: LGTM!

openspec/changes/architecture-01-solution-layer/proposal.md (1)

1-48: LGTM!

openspec/changes/governance-01-evidence-output/proposal.md (1)

1-48: LGTM!

openspec/changes/openspec-01-intent-trace/proposal.md (1)

1-48: LGTM!

openspec/changes/requirements-02-module-commands/proposal.md (1)

1-53: LGTM!

openspec/changes/requirements-03-backlog-sync/proposal.md (1)

1-49: LGTM!

openspec/changes/traceability-01-index-and-orphans/proposal.md (1)

1-48: LGTM!

openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/clean-code-analysis/spec.md (1)

1-1: LGTM!

openspec/changes/archive/2026-06-06-code-review-11-simplification-feedback-loop/specs/code-review-simplification-feedback/spec.md (1)

1-1: LGTM!

openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/bundle-overview-pages/spec.md (1)

3-3: LGTM!

openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-command-validation/spec.md (1)

3-3: LGTM!

openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-docs-publishing/spec.md (1)

3-3: LGTM!

openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/modules-pre-commit-quality-parity/spec.md (1)

3-3: LGTM!

openspec/changes/archive/2026-06-06-docs-15-code-review-validation-guardrails/specs/review-run-command/spec.md (1)

3-3: LGTM!

openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/backlog-delta/spec.md (1)

1-1: LGTM!

openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/code-review-tool-dependencies/spec.md (1)

1-1: LGTM!

openspec/changes/archive/2026-06-06-tester-module-cli-reliability/specs/modules-docs-command-validation/spec.md (1)

1-1: LGTM!

openspec/specs/ci-integration/spec.md (1)

73-73: LGTM!

openspec/specs/ci-module-signing-on-approval/spec.md (1)

54-54: LGTM!

Also applies to: 73-73

openspec/specs/modules-docs-publishing/spec.md (1)

52-67: LGTM!

openspec/specs/modules-pre-commit-quality-parity/spec.md (2)

28-43: LGTM!


44-53: LGTM!

openspec/specs/bundle-packaged-resources/spec.md (1)

6-21: LGTM!

openspec/specs/resource-aware-integrity/spec.md (3)

6-8: LGTM!


10-14: LGTM!


15-25: LGTM!

openspec/changes/validation-02-full-chain-engine/design.md (2)

3-3: LGTM!

Also applies to: 8-8, 15-15


39-39: Align validation-02-full-chain-engine prerequisites with specfact-cli (dependency summary correctness).

In openspec/changes/validation-02-full-chain-engine/design.md (dependency summary at line 39), the prerequisites include governance-01-evidence-output, traceability-01-index-and-orphans, and policy-02-packs-and-modes. In nold-ai/specfact-cli, the first two appear in openspec/CHANGE_ORDER.md, but policy-02-packs-and-modes has references without a corresponding CHANGE_ORDER entry (and no openspec/changes/policy-02-packs-and-modes directory found). Ensure this prerequisite is truly implemented/accepted in specfact-cli (or update the dependency summary/CHANGE_ORDER linkage accordingly).

openspec/changes/validation-02-full-chain-engine/proposal.md (2)

1-1: LGTM!

Also applies to: 13-18, 22-29, 35-40


49-49: Confirm nold-ai/specfact-cli#241 core counterpart alignment for validation-02

  • #241 exists (OPEN) and its scope matches the modules proposal: it keeps Req → Arch → Spec → Code → Tests as the only chain layers, adds optional --with-code-quality, and passes code_quality into the “governance evidence envelope” tied to the “traceability graph” framing (even though the issue title still says “Full-Chain Validation Engine”).
openspec/changes/validation-02-full-chain-engine/tasks.md (1)

5-9: LGTM!

Also applies to: 22-22

openspec/specs/review-finding-model/spec.md (1)

3-176: LGTM!

openspec/specs/code-review-ai-bloat-detection/spec.md (1)

1-11: LGTM!

Also applies to: 14-106

openspec/specs/clean-code-analysis/spec.md (1)

21-36: LGTM!

openspec/specs/code-review-simplification-feedback/spec.md (1)

1-12: LGTM!

Also applies to: 14-82

openspec/specs/guided-simplification-review/spec.md (1)

1-20: LGTM!

Also applies to: 22-68

openspec/specs/cleanup-forecast-review/spec.md (1)

1-44: LGTM!

openspec/specs/module-cli-error-contract/spec.md (1)

1-47: LGTM!

openspec/specs/review-run-command/spec.md (1)

188-211: LGTM!

openspec/specs/code-review-tool-dependencies/spec.md (1)

71-88: LGTM!

openspec/specs/prompt-command-validation/spec.md (1)

31-48: LGTM!

Comment thread openspec/specs/ai-ide-remediation-handoff/spec.md Outdated
Comment thread openspec/specs/backlog-sync/spec.md
Comment thread openspec/specs/ci-integration/spec.md
Comment thread openspec/specs/ci-module-signing-on-approval/spec.md
Comment thread openspec/specs/ci-module-signing-on-approval/spec.md Outdated
Comment thread openspec/specs/code-review-simplification-feedback/spec.md
Comment thread openspec/specs/guided-simplification-review/spec.md Outdated
Comment thread openspec/specs/module-command-overview/spec.md Outdated
Comment thread openspec/specs/modules-docs-publishing/spec.md Outdated
Comment thread openspec/specs/prompt-command-validation/spec.md Outdated
@djm81
djm81 merged commit ed11fdd into main Jun 6, 2026
16 of 17 checks passed
@github-project-automation github-project-automation Bot moved this from In Progress to Done in SpecFact CLI Jun 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

architecture Architecture-related topic change-proposal Proposal for a new change documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant