ai-core-framework 0.3.0 → 0.4.0

package/skills/using-ai-core/SKILL.md

@@ -42,13 +42,12 @@ If command metadata and user intent conflict, explain the conflict and stop.
 
 ## Source Of Truth
 
-- `docs/runtime/project/` is machine-readable AI Core runtime state.
+- `docs/runtime/` is AI Core runtime: state plus operational runtime docs.
 - `docs/project/` is human-readable project and product documentation.
-- `docs/runtime/` also contains operational AI Core documentation.
 - `docs/config/` is project configuration.
 - Root-level framework folders are portable framework code.
 
-Keep backlog, tickets, releases, bugs, sprints, and audit records under `docs/runtime/project/`. Generate human-readable summaries in `docs/runtime/project/views/` and keep longer narrative project/product docs in `docs/project/`.
+Keep backlog, tickets, releases, bugs, sprints, and audit records under `docs/runtime/`. Generate human-readable summaries in `docs/runtime/views/` and keep longer narrative project/product docs in `docs/project/`.
 
 ## Guided Report
 

package/skills/verification-before-done/SKILL.md

@@ -14,7 +14,7 @@ Before saying a workflow step is complete:
 1. Identify what proves the claim.
 2. Run or inspect the relevant verification.
 3. Read the result.
-4. Record evidence in `docs/runtime/project/test-runs/`, `docs/runtime/project/verifications/`, or the ticket.
+4. Record evidence in `docs/runtime/test-runs/`, `docs/runtime/verifications/`, or the ticket.
 5. Only then report completion.
 
 ## Required Evidence

package/templates/ci/ai-core-governance.yml

@@ -7,7 +7,7 @@ on:
       - "docs/config/**"
       - "docs/**"
       - "hooks/**"
-      - "docs/runtime/project/**"
+      - "docs/runtime/**"
       - "rules/**"
       - "scripts/**"
       - "skills/**"
@@ -21,7 +21,7 @@ on:
       - "docs/config/**"
       - "docs/**"
       - "hooks/**"
-      - "docs/runtime/project/**"
+      - "docs/runtime/**"
       - "rules/**"
       - "scripts/**"
       - "skills/**"
@@ -55,23 +55,23 @@ jobs:
       - name: Validate ticket schemas
         run: |
           set -e
-          for ticket in docs/runtime/project/tickets/*.json; do
+          for ticket in docs/runtime/tickets/*.json; do
             if [ ! -f "$ticket" ]; then continue; fi
             ajv validate -s docs/config/ticket.schema.json -d "$ticket"
           done
 
       - name: Validate backlog schema
         run: |
-          if [ ! -f "docs/runtime/project/backlog/backlog.json" ]; then
+          if [ ! -f "docs/runtime/backlog/backlog.json" ]; then
             echo "No backlog file, skipping"
             exit 0
           fi
-          ajv validate -s docs/config/backlog.schema.json -d docs/runtime/project/backlog/backlog.json
+          ajv validate -s docs/config/backlog.schema.json -d docs/runtime/backlog/backlog.json
 
       - name: Validate release schemas
         run: |
           set -e
-          for release in docs/runtime/project/releases/*.json; do
+          for release in docs/runtime/releases/*.json; do
             if [ ! -f "$release" ]; then continue; fi
             ajv validate -s docs/config/release.schema.json -d "$release"
           done
@@ -95,7 +95,7 @@ jobs:
       - name: Check state history immutability
         if: github.event_name == 'pull_request'
         run: |
-          CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD -- 'docs/runtime/project/tickets/*.json' || true)
+          CHANGED=$(git diff --name-only origin/${{ github.base_ref }}...HEAD -- 'docs/runtime/tickets/*.json' || true)
           if [ -z "$CHANGED" ]; then
             echo "No ticket changes"
             exit 0

package/templates/pr/pull-request-template.md

@@ -11,7 +11,7 @@ Instructions for developer:
 
 <!-- 1-3 sentences: what does this PR do and why? -->
 
-**Ticket**: [TICKET-XXX](./docs/runtime/project/tickets/TICKET-XXX.json) <!-- Auto-filled by /create-pr -->
+**Ticket**: [TICKET-XXX](./docs/runtime/tickets/TICKET-XXX.json) <!-- Auto-filled by /create-pr -->
 
 **Type**: <!-- feature | bugfix | hotfix | refactor | chore | docs -->
 

package/templates/project/CODEOWNERS

@@ -8,7 +8,7 @@
 /templates/ @tech-leads
 /workflows/ @tech-leads
 /docs/config/ @scrum-masters @tech-leads
-/docs/runtime/project/ @scrum-masters @tech-leads
+/docs/runtime/ @scrum-masters @tech-leads
 /docs/runtime/adr/ @tech-leads
 /docs/project/specs/ @product-owners @tech-leads
 /docs/project/plans/ @tech-leads

package/templates/project/project-structure.yaml

@@ -2,17 +2,17 @@
 # Framework folders remain framework-only. Runtime state and project docs live outside them.
 
 state:
-  root: "docs/runtime/project"
-  tickets: "docs/runtime/project/tickets"
-  backlog: "docs/runtime/project/backlog"
-  bugs: "docs/runtime/project/bugs"
-  sprints: "docs/runtime/project/sprints"
-  releases: "docs/runtime/project/releases"
-  metrics: "docs/runtime/project/metrics"
-  views: "docs/runtime/project/views"
-  test_runs: "docs/runtime/project/test-runs"
-  incidents: "docs/runtime/project/incidents"
-  audit_log: "docs/runtime/project/audit-log.jsonl"
+  root: "docs/runtime"
+  tickets: "docs/runtime/tickets"
+  backlog: "docs/runtime/backlog"
+  bugs: "docs/runtime/bugs"
+  sprints: "docs/runtime/sprints"
+  releases: "docs/runtime/releases"
+  metrics: "docs/runtime/metrics"
+  views: "docs/runtime/views"
+  test_runs: "docs/runtime/test-runs"
+  incidents: "docs/runtime/incidents"
+  audit_log: "docs/runtime/audit-log.jsonl"
 
 project_docs:
   root: "docs/project"
@@ -36,9 +36,9 @@ runtime_docs:
   incidents: "docs/runtime/incidents"
 
 backlog:
-  source_of_truth: "docs/runtime/project/backlog/backlog.json"
-  ticket_details: "docs/runtime/project/tickets/TICKET-XXX.json"
-  generated_views: "docs/runtime/project/views"
+  source_of_truth: "docs/runtime/backlog/backlog.json"
+  ticket_details: "docs/runtime/tickets/TICKET-XXX.json"
+  generated_views: "docs/runtime/views"
 
 ticket_docs:
   spec_path_field: "spec_path"
@@ -53,7 +53,7 @@ refactor:
   requires_adr_when_architectural: true
 
 release:
-  records: "docs/runtime/project/releases/vX.Y.Z.json"
+  records: "docs/runtime/releases/vX.Y.Z.json"
   schema: "docs/config/release.schema.json"
   template: "templates/release/release-record-template.json"
   requires_rollback_verification: true
@@ -65,7 +65,7 @@ scripts:
   command_runner: "scripts/ai-core.sh"
   workflow_handlers: "scripts/workflow.sh"
   audit_validator: "scripts/validate-audit-log.sh"
-  audit_log: "docs/runtime/project/audit-log.jsonl"
+  audit_log: "docs/runtime/audit-log.jsonl"
 
 ci:
   governance_template: "templates/ci/ai-core-governance.yml"

package/workflows/bug-lifecycle.md

@@ -10,7 +10,7 @@ Make bugs reproducible, prioritized, fixed with regression coverage, and verifie
 
 1. Discovery
    - Any agent or user reports a defect with `/report-bug`.
-   - Bug is created in `docs/runtime/project/bugs/` with status `NEW` or `NEEDS_MORE_INFO`.
+   - Bug is created in `docs/runtime/bugs/` with status `NEW` or `NEEDS_MORE_INFO`.
 
 2. Triage
    - BA runs `/triage-bug` with Tech Lead and QA input.
@@ -46,8 +46,8 @@ Make bugs reproducible, prioritized, fixed with regression coverage, and verifie
 
 ## 📊 Artifacts
 
-- `docs/runtime/project/bugs/BUG-XXX.json`
-- Linked ticket in `docs/runtime/project/tickets/`
+- `docs/runtime/bugs/BUG-XXX.json`
+- Linked ticket in `docs/runtime/tickets/`
 - Verification report
 - Regression tests
 

package/workflows/feature-lifecycle.md

@@ -82,7 +82,7 @@
 3. BA writes User Story (INVEST)
 4. BA writes ≥3 AC scenarios (Gherkin)
 5. BA creates `docs/project/specs/TICKET-XXX-<slug>.md`
-6. BA creates `docs/runtime/project/tickets/TICKET-XXX.json` with `spec_path`
+6. BA creates `docs/runtime/tickets/TICKET-XXX.json` with `spec_path`
 7. BA output HANDOFF → tech-lead
 
 ### Gates
@@ -181,7 +181,7 @@ Each requirement should finish in one session (< 30 minutes of BA work).
    - Sort by priority (MUST > SHOULD > COULD)
    - Pull tickets into sprint until capacity is reached (30 points default)
    - Assign tickets to sprint
-3. Create `docs/runtime/project/sprints/SPRINT-XXX.json`
+3. Create `docs/runtime/sprints/SPRINT-XXX.json`
 
 ### Gates
 - ✅ Total points ≤ team capacity

package/workflows/sprint-lifecycle.md

@@ -46,8 +46,8 @@ Ensure sprint commitments are realistic, tracked, and closed with factual metric
 
 ## 📊 Artifacts
 
-- `docs/runtime/project/sprints/SPRINT-XXX.json`
-- `docs/runtime/project/metrics/`
+- `docs/runtime/sprints/SPRINT-XXX.json`
+- `docs/runtime/metrics/`
 - Retrospective notes
 - Sprint report