docs(openspec): update 3 requirements to match the code

[openspec-cloud]

Last scanned: 2026-08-20 23:57 UTC

▶ View full results and scan again

The assessment found 3 requirements that no longer matched the code. OpenSpec Cloud proposed updates only for those requirements.

The scan was incomplete: 1 requirement could not be judged. These updates cover only citation-gated findings; this pull request is not a clean result for the repository.

The scan reported 43 findings in total. The other 40 need a person rather than a specification edit and stay in the check.

Scope: this pull request edits openspec/ files only.

Review Files changed before merging. OpenSpec Cloud never approves or merges this proposal.

Scan history and manual trigger

• 2026-08-20 23:57 UTC · View results
• 2026-08-20 21:59 UTC · View results

Comment /openspec-cloud on this correction pull request to request a fresh repository scan.

View the complete originating check.

🔎 3 requirements drifted — 3 at stale specs.

AI-generated · A citation proves the line exists, not that it makes the case — verify before acting.

Not a clean result. 18 requirement(s) were not verified.

🟣 Stale specs (2)

🟣 Path configuration for supported tools — spec is out of date · high

Expected — openspec/specs/ai-tool-paths/spec.md:21

The `AI_TOOLS` array SHALL include `skillsDir` for tools that support the Agent Skills specification.

Observed — src/core/config.ts:50

{ name: 'Devin Desktop (formerly Windsurf)', value: 'devin', available: true, successLabel: 'Devin Desktop', skillsDir: '.devin', detectionPaths: ['.devin', '.windsurf'], requiresIdeRestart: true },

Next → update the requirement to match the code.

Proposed requirement update:

--- a/openspec/specs/ai-tool-paths/spec.md
+++ b/openspec/specs/ai-tool-paths/spec.md
@@ -35,7 +35,7 @@
 #### Scenario: Windsurf paths defined
 
 - **WHEN** looking up the `windsurf` tool
-- **THEN** `skillsDir` SHALL be `.windsurf`
+- **THEN** `skillsDir` SHALL be `.devin`
 
 #### Scenario: Kimi Code paths defined
 

🟣 Experimental Isolation — spec is out of date · high

Expected — openspec/specs/cli-artifact-workflow/spec.md:186

The system SHALL implement artifact workflow commands in isolation for easy removal.

Observed — src/commands/workflow/index.ts:7

export { statusCommand } from './status.js';

Next → update the requirement to match the code.

Proposed requirement update:

--- a/openspec/specs/cli-artifact-workflow/spec.md
+++ b/openspec/specs/cli-artifact-workflow/spec.md
@@ -188,7 +188,7 @@
 
 #### Scenario: Single file implementation
 - **WHEN** artifact workflow feature is implemented
-- **THEN** all commands are in `src/commands/artifact-workflow.ts`
+- **THEN** all commands are in `src/commands/workflow`
 
 #### Scenario: Help text marking
 - **WHEN** user runs `--help` on any artifact workflow command

1 finding is omitted from this field to stay within its limit; review the complete originating check for every finding.

[openspec-cloud]

✅ Specs and code agree — nothing to do.

AI-generated · A citation proves the line exists, not that it makes the case — verify before acting.
Checked the 4 requirements selected for this PR at e501b74 (252 total).
View results · Click Refresh, then Scan again in the check. Or comment /openspec-cloud.

[openspec-cloud]

▶ View full results and scan again

🔎 43 requirements drifted — 33 pointing at code, 10 needing a decision.

AI-generated · A citation proves the line exists, not that it makes the case — verify before acting.

On 1ebddd1; 1 requirement could not be judged — not a clean result.

🔴 CI Job Integration — code is wrong · high

Expected — openspec/specs/ci-nix-validation/spec.md:45

The Nix validation jobs SHALL be integrated into the existing GitHub Actions workflow and required for merge.

Observed — .github/workflows/ci.yml:171

if: needs.changes.outputs.nix == 'true'

Next → fix the code at .github/workflows/ci.yml:171 so it satisfies the requirement.
Protect the fix: add a regression check and link it from this requirement.

🔴 Nix Flake Build Validation — code is wrong · high

Expected — openspec/specs/ci-nix-validation/spec.md:7

The CI system SHALL validate that the Nix flake builds successfully on every pull request and push to main.

Observed — .github/workflows/ci.yml:170

needs: changes

Next → fix the code at .github/workflows/ci.yml:170 so it satisfies the requirement.
Protect the fix: add a regression check and link it from this requirement.

🔴 Nix Installation in CI — code is wrong · high

Expected — openspec/specs/ci-nix-validation/spec.md:76

The CI environment SHALL have Nix properly installed and configured before running validation.

Observed — .github/workflows/ci.yml:282

needs: [test_matrix, lint, nix-flake-validate]

Next → fix the code at .github/workflows/ci.yml:282 so it satisfies the requirement.
Protect the fix: add a regression check and link it from this requirement.

40 more findings are in the full check.

View results · Click Refresh, then Scan again in the check. Or comment /openspec-cloud.