ai-core-framework 0.1.0 → 0.2.0

package/{core/templates → templates}/ci/ai-core-governance.yml

@@ -3,20 +3,30 @@ name: AI Core Governance
 on:
   pull_request:
     paths:
-      - "core/**"
+      - "agents/**"
       - "config/**"
-      - "project/**"
       - "docs/**"
+      - "hooks/**"
+      - "project/**"
+      - "rules/**"
       - "scripts/**"
+      - "skills/**"
+      - "templates/**"
+      - "workflows/**"
       - ".github/workflows/ai-core-governance.yml"
   push:
     branches: [main, develop, "release/**"]
     paths:
-      - "core/**"
+      - "agents/**"
       - "config/**"
-      - "project/**"
       - "docs/**"
+      - "hooks/**"
+      - "project/**"
+      - "rules/**"
       - "scripts/**"
+      - "skills/**"
+      - "templates/**"
+      - "workflows/**"
       - ".github/workflows/ai-core-governance.yml"
 
 concurrency:
@@ -40,14 +50,14 @@ jobs:
           npm install -g ajv-cli@5
 
       - name: Make scripts executable
-        run: chmod +x core/scripts/*.sh
+        run: chmod +x scripts/*.sh
 
       - name: Validate ticket schemas
         run: |
           set -e
           for ticket in project/tickets/*.json; do
             if [ ! -f "$ticket" ]; then continue; fi
-            ajv validate -s core/config/ticket.schema.json -d "$ticket"
+            ajv validate -s config/ticket.schema.json -d "$ticket"
           done
 
       - name: Validate backlog schema
@@ -56,31 +66,31 @@ jobs:
             echo "No backlog file, skipping"
             exit 0
           fi
-          ajv validate -s core/config/backlog.schema.json -d project/backlog/backlog.json
+          ajv validate -s config/backlog.schema.json -d project/backlog/backlog.json
 
       - name: Validate release schemas
         run: |
           set -e
           for release in project/releases/*.json; do
             if [ ! -f "$release" ]; then continue; fi
-            ajv validate -s core/config/release.schema.json -d "$release"
+            ajv validate -s config/release.schema.json -d "$release"
           done
 
       - name: Validate state
-        run: bash core/scripts/validate-state.sh
+        run: bash scripts/validate-state.sh
 
       - name: Validate docs
         if: github.event_name == 'pull_request'
-        run: bash core/scripts/validate-docs.sh --base origin/${{ github.base_ref }}
+        run: bash scripts/validate-docs.sh --base origin/${{ github.base_ref }}
 
       - name: Validate permissions
-        run: bash core/scripts/validate-permissions.sh
+        run: bash scripts/validate-permissions.sh
 
       - name: Validate audit log
-        run: bash core/scripts/validate-audit-log.sh
+        run: bash scripts/validate-audit-log.sh
 
       - name: Generate views smoke test
-        run: bash core/scripts/generate-views.sh
+        run: bash scripts/generate-views.sh
 
       - name: Check state history immutability
         if: github.event_name == 'pull_request'

package/{core/templates → templates}/project/CODEOWNERS

@@ -1,7 +1,12 @@
 # AI Core governance ownership.
 #
 # Replace placeholder teams/users for each consuming repo.
-/core/ @tech-leads
+/agents/ @tech-leads
+/rules/ @tech-leads
+/scripts/ @tech-leads
+/skills/ @tech-leads
+/templates/ @tech-leads
+/workflows/ @tech-leads
 /config/ @scrum-masters @tech-leads
 /project/ @scrum-masters @tech-leads
 /docs/runtime/adr/ @tech-leads

package/templates/project/docs-policy.json

@@ -0,0 +1,3 @@
+{
+  "extends": "config/docs-policy.default.json"
+}

package/{core/templates → templates}/project/project-structure.yaml

@@ -1,5 +1,5 @@
 # Project-specific structure map copied by /setup-project into config/project-structure.yaml
-# core remains framework-only. Runtime state and project docs live outside core.
+# Framework folders remain framework-only. Runtime state and project docs live outside them.
 
 state:
   root: "project"
@@ -48,29 +48,29 @@ ticket_docs:
 
 refactor:
   plan_dir: "docs/runtime/refactor"
-  template: "core/templates/technical/refactor-plan-template.md"
+  template: "templates/technical/refactor-plan-template.md"
   requires_ticket_breakdown: true
   requires_adr_when_architectural: true
 
 release:
   records: "project/releases/vX.Y.Z.json"
-  schema: "core/config/release.schema.json"
-  template: "core/templates/release/release-record-template.json"
+  schema: "config/release.schema.json"
+  template: "templates/release/release-record-template.json"
   requires_rollback_verification: true
   requires_post_release_smoke: true
 
 scripts:
-  canonical: "core/scripts"
+  canonical: "scripts"
   generated_root: "scripts"
-  command_runner: "core/scripts/ai-core.sh"
-  workflow_handlers: "core/scripts/workflow.sh"
-  audit_validator: "core/scripts/validate-audit-log.sh"
+  command_runner: "scripts/ai-core.sh"
+  workflow_handlers: "scripts/workflow.sh"
+  audit_validator: "scripts/validate-audit-log.sh"
   audit_log: "project/audit-log.jsonl"
 
 ci:
-  governance_template: "core/templates/ci/ai-core-governance.yml"
-  app_templates: "core/templates/ci"
+  governance_template: "templates/ci/ai-core-governance.yml"
+  app_templates: "templates/ci"
 
 docs_policy:
   project_override: "config/docs-policy.json"
-  default: "core/config/docs-policy.default.json"
+  default: "config/docs-policy.default.json"

package/{core/templates → templates}/qa/bug-report-template.md

@@ -367,5 +367,5 @@ DO NOT EDIT BELOW - auto-populated
 -->
 
 <!-- TEMPLATE_VERSION: 1.0.0 -->
-<!-- SCHEMA: core/config/bug.schema.json -->
+<!-- SCHEMA: config/bug.schema.json -->
 <!-- FILED_BY_AGENT: [agent-name] -->

package/{core/templates → templates}/requirements/user-story-template.md

@@ -378,4 +378,4 @@ DO NOT EDIT BELOW - auto-populated fields
 <!-- TEMPLATE_VERSION: 1.0.0 -->
 <!-- CREATED_BY_AGENT: business-analyst -->
 <!-- NEXT_AGENT: tech-lead -->
-<!-- SCHEMA: core/config/ticket.schema.json -->
+<!-- SCHEMA: config/ticket.schema.json -->

package/core/README.md

@@ -1,162 +0,0 @@
-# AI Core, Enterprise SDLC Framework
-
-> Framework source of truth for AI agents, commands, rules, templates, and workflows.
-> Compatible with Claude Code, Cursor, and Windsurf.
-
-## 🎯 Purpose
-
-AI Core turns AI coding assistants into a small structured delivery team following Agile/Scrum roles: BA, Tech Lead, Developer, QA, and Scrum Master.
-
-Important separation:
-
-- `core/` is framework-only and should be portable across projects.
-- `config/` is project-specific configuration.
-- `project/` is project-specific runtime state.
-- `docs/project/` contains product and project documentation such as requirements, specs, plans, and API docs.
-- `docs/runtime/` contains operational AI Core documentation such as ADRs, refactor plans, runbooks, QA evidence, and technical notes.
-
-## 📁 Framework structure
-
-`core/` contains reusable framework assets only:
-
-- `agents/`, role definitions
-- `commands/`, slash-command workflows
-- `rules/`, strict constraints AI must follow
-- `templates/`, reusable document templates
-- `workflows/`, lifecycle specs
-- `config/`, framework schemas only
-- `scripts/`, framework utilities
-
-`core/` MUST NOT contain project runtime state such as tickets, backlog, sprints, releases, or bugs.
-
-## 📁 Project runtime structure
-
-A project using this framework should have:
-
-- `config/project-config.yaml`, project-specific settings
-- `config/project-structure.yaml`, path conventions for this project
-- `project/backlog/backlog.json`, backlog ordering and prioritization source of truth
-- `project/tickets/TICKET-XXX.json`, ticket details and state machine history
-- `project/bugs/BUG-XXX.json`, bug state
-- `project/sprints/SPRINT-XXX.json`, sprint plans and reports
-- `project/releases/vX.Y.Z.json`, release records
-- `project/user-requests.jsonl`, append-only user request log
-- `project/views/`, generated views for humans
-- `docs/project/requirements/`, reverse-documented and stakeholder-provided requirements
-- `docs/project/specs/`, approved feature and behavior specs
-- `docs/project/user-stories/`, user story drafts and supporting product notes
-- `docs/project/plans/`, implementation plans linked from tickets
-- `docs/project/api/`, API documentation
-- `docs/runtime/refactor/`, refactor plans
-- `docs/runtime/adr/`, Architecture Decision Records
-- `docs/runtime/technical/`, technical designs
-- `docs/runtime/runbooks/`, operational runbooks
-- `docs/runtime/qa/`, QA plans and reports
-
-## 🚀 Quick Start
-
-1. Copy `core/` into your project root.
-2. Run `/setup-project` to create `config/`, `project/`, and docs scaffolding.
-3. Run `/sync-platforms` to export framework instructions to Claude Code, Cursor, and Windsurf.
-4. Start with `/detect-stack`, `/discover-codebase`, then `/analyze-requirements`.
-
-## 🧭 Guided workflow
-
-This framework is chat-first. In your AI chat window, type the workflow command directly:
-
-```text
-/analyze-requirements "User can reset password"
-/groom-ticket TICKET-001 5
-next TICKET-001
-```
-
-The AI must infer the correct agent from command metadata (`owner_agent` / `requires_agents`). Users should not need to type agent names. The executable runner exists for AI tooling and CI, not as the normal user interface.
-
-For guided mode, ask naturally:
-
-```text
-guide /groom-ticket TICKET-001 5
-```
-
-The AI should execute one step, report the completed command, ticket state before/after, updated `project` files, validation results, and the next recommended chat command. It must ask before continuing and must not auto-run steps requiring missing arguments like `<story_points>` or `<pr_url>`.
-
-## 🤖 Agents
-
-| Agent | Role | Can do | Must not do |
-|-------|------|--------|-------------|
-| `business-analyst` | BA + PM | Requirements, user stories, backlog priority | Write code, technical estimate |
-| `tech-lead` | Architect + reviewer | Design, review, ADR, security | Self-merge own PR |
-| `developer` | Engineer | Implement tasks and tests | Merge PR, approve own work |
-| `qa-tester` | QA | Test plan, bug report, fix verification | Modify production code |
-| `scrum-master` | Delivery coordinator | Sprint planning, release, metrics | Technical decisions |
-
-## ⚙️ Commands
-
-See `commands/README.md` for the full catalog.
-
-Core workflow:
-
-`/analyze-requirements` → `/groom-ticket` → `/write-plan` → `/mark-ready` → `/plan-sprint` → `/implement-task` → `/create-pr` → `/techlead-review` → `/merge-pr` → `/smoke-test`
-
-Project setup and reporting:
-
-- `/setup-project`
-- `/detect-stack`
-- `/discover-codebase`
-- `/validate-state`
-- `/sprint-report`
-- `/sync-platforms`
-
-## 📊 State Machine
-
-Tickets in `project/tickets/` move through:
-
-`DRAFT → GROOMED → READY → IN_PROGRESS → IN_REVIEW → QA → DONE`
-
-Side states:
-
-- `BLOCKED`
-- `CANCELLED`
-
-Transitions must go through commands, not manual JSON edits.
-
-## 📌 Backlog model
-
-Backlog source of truth is `project/backlog/backlog.json`.
-
-Ticket details are in `project/tickets/TICKET-XXX.json`.
-
-Generated views can be written to `project/views/`.
-
-This avoids treating the ticket folder itself as the backlog. The ticket folder stores ticket details, while the backlog file owns ranking and prioritization.
-
-## 🧱 Refactor planning
-
-Large refactors should use:
-
-- `docs/runtime/refactor/<name>-refactor-plan.md`
-- `core/templates/technical/refactor-plan-template.md`
-- `docs/runtime/adr/NNN-title.md` if the refactor changes architecture
-- `project/tickets/TICKET-XXX.json` for each executable refactor step
-
-## 🛠️ Platform Sync
-
-User-facing command:
-
-```text
-/sync-platforms
-```
-
-Internal executable used by AI tooling/CI:
-
-`bash core/scripts/sync-platforms.sh`
-
-Generated files:
-
-- `.claude/agents/`
-- `.claude/commands/`
-- `CLAUDE.md`
-- `.cursor/rules/*.mdc`
-- `.windsurfrules`
-
-Generated files are exports. Edit `core/` source files instead.

package/core/templates/project/docs-policy.json

@@ -1,3 +0,0 @@
-{
-  "extends": "core/config/docs-policy.default.json"
-}