Reorganized capabilities

Author: PredictabilityAtScale

.capabilities/core/agents/ingest-agent-review-result.capability.yaml

@@ -0,0 +1,52 @@
+id: core/agents/ingest-agent-review-result
+title: Ingest agent review result
+status: implemented
+area: core
+summary: Validate structured agent review output and optionally save it as
+  capability review evidence.
+intent: Turn external agent review prose into durable, policy-safe evidence
+  without automatically changing capability status.
+acceptance:
+  - Parses the structured JSON output requested by agent-review prompts.
+  - Validates reviewed criteria against the capability acceptance criteria.
+  - Requires file-path evidence for criteria marked covered or partial.
+  - Reports malformed review output, missing criteria, and missing evidence
+    paths as validation issues.
+  - Saves valid review evidence under agent.review without automatically
+    changing capability status.
+guidance:
+  - Keep ingestion separate from verification policy.
+  - Do not mark a capability verified solely because an agent set done true.
+  - Preserve enough criterion-level evidence for later human or automated
+    policy review.
+agent:
+  inputs:
+    - capability ID
+    - structured agent review JSON output
+    - capability acceptance criteria
+    - review evidence paths
+  outputs:
+    - validated review result
+    - agent.review evidence in the capability file
+  depends_on:
+    - core/agents/review-capability-with-agent
+  implementation:
+    references:
+      - packages/core/src/agentReviewResult.ts
+      - packages/core/src/schema.ts
+      - packages/core/src/types.ts
+      - packages/core/src/index.ts
+      - packages/cli/src/index.ts
+      - packages/core/tests/agentReviewResult.test.ts
+  verification:
+    automated:
+      - id: agent-review-result-tests
+        description: Unit tests cover valid review ingestion, validation issues,
+          and saving agent.review without status changes.
+        command: npm test -- packages/core/tests/agentReviewResult.test.ts
+      - id: cli-build
+        description: TypeScript build verifies exported APIs and CLI integration.
+        command: npm run build
+    manual:
+      - Run review-result with a saved agent-review JSON response and confirm
+        the capability status is unchanged while agent.review is populated.

…repare-agent-task-bundle.capability.yaml …repare-agent-task-bundle.capability.yaml.capabilities/core/prepare-agent-task-bundle.capability.yaml renamed to .capabilities/core/agents/prepare-agent-task-bundle.capability.yaml .capabilities/core/prepare-agent-task-bundle.capability.yaml renamed to .capabilities/core/agents/prepare-agent-task-bundle.capability.yaml

@@ -1,4 +1,4 @@
-id: core/prepare-agent-task-bundle
+id: core/agents/prepare-agent-task-bundle
 title: Prepare agent task bundle
 status: implemented
 area: core
@@ -29,8 +29,8 @@ agent:
   outputs:
     - agent task prompt bundle
   depends_on:
-    - core/compile-capabilities
-    - core/verify-implementation-references
+    - core/graph/compile-capabilities
+    - core/validation/verify-implementation-references
   implementation:
     references:
       - packages/core/src/agentTask.ts
@@ -44,7 +44,7 @@ agent:
         command: npm test -- packages/core/tests/agentTask.test.ts
       - id: dogfood-agent-task
         description: The CLI generates an implementation bundle for this capability.
-        command: node packages/cli/dist/index.js agent-task core/prepare-agent-task-bundle --mode implement
+        command: node packages/cli/dist/index.js agent-task core/agents/prepare-agent-task-bundle --mode implement
     manual:
       - Generate implement and review bundles and confirm they are clear enough
         to paste into an external coding agent.

…ew-capability-with-agent.capability.yaml …ew-capability-with-agent.capability.yaml.capabilities/core/review-capability-with-agent.capability.yaml renamed to .capabilities/core/agents/review-capability-with-agent.capability.yaml .capabilities/core/review-capability-with-agent.capability.yaml renamed to .capabilities/core/agents/review-capability-with-agent.capability.yaml

@@ -1,4 +1,4 @@
-id: core/review-capability-with-agent
+id: core/agents/review-capability-with-agent
 title: Review capability with agent
 status: implemented
 area: core
@@ -29,8 +29,8 @@ agent:
     - structured acceptance coverage review
     - unresolved gaps or uncertain criteria
   depends_on:
-    - core/prepare-agent-task-bundle
-    - core/assess-implementation-coverage
+    - core/agents/prepare-agent-task-bundle
+    - core/assessment/assess-implementation-coverage
   implementation:
     references:
       - packages/core/src/agentReview.ts
@@ -47,7 +47,7 @@ agent:
         command: npm test -- packages/core/tests/agentReview.test.ts
       - id: dogfood-agent-review-dry-run
         description: The CLI prepares a Codex review handoff without executing the agent.
-        command: node packages/cli/dist/index.js agent-review core/review-capability-with-agent --command codex --arg exec --handoff stdin --dry-run --no-references
+        command: node packages/cli/dist/index.js agent-review core/agents/review-capability-with-agent --command codex --arg exec --handoff stdin --dry-run --no-references
     manual:
       - Run a review bundle through Codex or Claude Code and confirm the output
         is usable as acceptance evidence.

…e/run-external-agent-cli.capability.yaml …s/run-external-agent-cli.capability.yaml.capabilities/core/run-external-agent-cli.capability.yaml renamed to .capabilities/core/agents/run-external-agent-cli.capability.yaml .capabilities/core/run-external-agent-cli.capability.yaml renamed to .capabilities/core/agents/run-external-agent-cli.capability.yaml

@@ -1,4 +1,4 @@
-id: core/run-external-agent-cli
+id: core/agents/run-external-agent-cli
 title: Run external agent CLI
 status: implemented
 area: core
@@ -33,7 +33,7 @@ agent:
     - external agent run transcript
     - actionable installation or configuration error
   depends_on:
-    - core/prepare-agent-task-bundle
+    - core/agents/prepare-agent-task-bundle
   implementation:
     references:
       - packages/core/src/externalAgent.ts

…-implementation-coverage.capability.yaml …-implementation-coverage.capability.yaml.capabilities/core/assess-implementation-coverage.capability.yaml renamed to .capabilities/core/assessment/assess-implementation-coverage.capability.yaml .capabilities/core/assess-implementation-coverage.capability.yaml renamed to .capabilities/core/assessment/assess-implementation-coverage.capability.yaml

@@ -1,4 +1,4 @@
-id: core/assess-implementation-coverage
+id: core/assessment/assess-implementation-coverage
 title: Assess implementation coverage
 status: implemented
 area: core
@@ -30,7 +30,7 @@ agent:
     - implementation coverage report
     - uncovered or uncertain acceptance criteria
   depends_on:
-    - core/verify-implementation-references
+    - core/validation/verify-implementation-references
   implementation:
     references:
       - packages/core/src/assessImplementationCoverage.ts
@@ -45,9 +45,9 @@ agent:
         command: npm test -- packages/core/tests/assessImplementationCoverage.test.ts
       - id: dogfood-coverage-report
         description: The CLI reports implementation coverage for this capability.
-        command: node packages/cli/dist/index.js assess core/assess-implementation-coverage
+        command: node packages/cli/dist/index.js assess core/assessment/assess-implementation-coverage
     manual:
-      - Run the coverage report against core/verify-implementation-references
+      - Run the coverage report against core/validation/verify-implementation-references
         and confirm the output gives a reviewer enough context to judge the
         implementation.
     gaps:

.capabilities/core/graph/analyze-capability-impact.capability.yaml

@@ -0,0 +1,49 @@
+id: core/graph/analyze-capability-impact
+title: Analyze capability impact
+status: implemented
+area: core
+summary: Report downstream capabilities that may need review or testing when a
+  capability changes.
+intent: Help maintainers and agents understand the blast radius of capability
+  changes by traversing reverse dependency relationships and surfacing relevant
+  verification guidance.
+acceptance:
+  - Builds direct and transitive dependent relationships from agent.depends_on.
+  - Reports impacted capabilities for a selected capability.
+  - Includes suggested automated checks from the selected and impacted
+    capabilities.
+  - Includes manual review guidance and verification gaps for the impacted set.
+  - Exposes impact data through the compiled capability artifact and CLI.
+guidance:
+  - Keep the existing dependency_graph output backward-compatible.
+  - Treat deeper folder hierarchy as navigation and ownership context, not as a
+    replacement for explicit depends_on relationships.
+agent:
+  inputs:
+    - .capabilities/**/*.capability.yaml
+    - capability agent.depends_on values
+  outputs:
+    - impact report
+    - compiled impact graph
+  depends_on:
+    - core/graph/compile-capabilities
+    - core/validation/validate-capability-files
+  implementation:
+    references:
+      - packages/core/src/capabilityImpact.ts
+      - packages/core/src/compileCapabilities.ts
+      - packages/core/src/index.ts
+      - packages/cli/src/index.ts
+      - packages/core/tests/capabilityImpact.test.ts
+      - packages/core/tests/compile.test.ts
+  verification:
+    automated:
+      - id: impact-tests
+        description: Unit tests verify reverse and transitive impact analysis.
+        command: npm test -- packages/core/tests/capabilityImpact.test.ts packages/core/tests/compile.test.ts
+      - id: dogfood-impact
+        description: The CLI reports impact for a core capability.
+        command: npm run capabilitykit -- impact core/graph/compile-capabilities
+    manual:
+      - Change or inspect a foundational capability and confirm the impact
+        report identifies direct and transitive dependents that need review.

…ore/compile-capabilities.capability.yaml …aph/compile-capabilities.capability.yaml.capabilities/core/compile-capabilities.capability.yaml renamed to .capabilities/core/graph/compile-capabilities.capability.yaml .capabilities/core/compile-capabilities.capability.yaml renamed to .capabilities/core/graph/compile-capabilities.capability.yaml

@@ -1,4 +1,4 @@
-id: core/compile-capabilities
+id: core/graph/compile-capabilities
 title: Compile capabilities
 status: implemented
 area: core
@@ -19,10 +19,10 @@ agent:
   inputs:
     - .capabilities/**/*.capability.yaml
   outputs:
-    - .capabilities/dist/capabilities.json
+    - configured compiled capability JSON output
   depends_on:
-    - core/define-capability-format
-    - core/validate-capability-files
+    - core/model/define-capability-format
+    - core/validation/validate-capability-files
   implementation:
     references:
       - packages/core/src/compileCapabilities.ts
@@ -36,5 +36,5 @@ agent:
         description: The CLI compiles CapabilityKit's own capability map.
         command: npm run capabilitykit -- compile
     manual:
-      - Inspect .capabilities/dist/capabilities.json after compile and confirm
+      - Inspect the configured compiled JSON output after compile and confirm
         the graph is readable.

…s/core/define-capability.capability.yaml …define-capability-format.capability.yaml.capabilities/core/define-capability.capability.yaml renamed to .capabilities/core/model/define-capability-format.capability.yaml .capabilities/core/define-capability.capability.yaml renamed to .capabilities/core/model/define-capability-format.capability.yaml

@@ -1,4 +1,4 @@
-id: core/define-capability-format
+id: core/model/define-capability-format
 title: Define capability format
 status: implemented
 area: core

…/core/initialize-project.capability.yaml …alize-capability-project.capability.yaml.capabilities/core/initialize-project.capability.yaml renamed to .capabilities/core/project/initialize-capability-project.capability.yaml .capabilities/core/initialize-project.capability.yaml renamed to .capabilities/core/project/initialize-capability-project.capability.yaml

@@ -1,4 +1,4 @@
-id: core/initialize-capability-project
+id: core/project/initialize-capability-project
 title: Initialize capability project
 status: implemented
 area: core
@@ -19,7 +19,7 @@ agent:
     - .capabilities/capabilitykit.yaml
     - .capabilities/example.capability.yaml
   depends_on:
-    - core/define-capability-format
+    - core/model/define-capability-format
   implementation:
     references:
       - packages/cli/src/index.ts

…detect-verification-gaps.capability.yaml …detect-verification-gaps.capability.yaml.capabilities/core/detect-verification-gaps.capability.yaml renamed to .capabilities/core/validation/detect-verification-gaps.capability.yaml .capabilities/core/detect-verification-gaps.capability.yaml renamed to .capabilities/core/validation/detect-verification-gaps.capability.yaml

@@ -1,4 +1,4 @@
-id: core/detect-verification-gaps
+id: core/validation/detect-verification-gaps
 title: Detect verification gaps
 status: implemented
 area: core
@@ -21,7 +21,7 @@ agent:
   outputs:
     - verification gap list
   depends_on:
-    - core/define-capability-format
+    - core/model/define-capability-format
   implementation:
     references:
       - packages/core/src/validateCapabilities.ts