ac-framework 1.5.0 → 1.6.0

package/framework/copilot-instructions.md

@@ -1,48 +1,6 @@
-# 🤖 AGENTS.md - AI Work Framework
+**Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
 
-```
-╔══════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                          ║
-║    █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗                                  ║
-║   ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝                                  ║
-║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗                                  ║
-║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║                                  ║
-║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║                                  ║
-║   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝                                  ║
-║                                                                                          ║
-║                    Intelligent Software Development Framework                            ║
-║                                                                                          ║
-╚══════════════════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## 📋 Index
-
-1. [Framework Philosophy](#-framework-philosophy)
-2. [Available Skills](#-available-skills)
-3. [Workflow: New Project](#-workflow-new-project)
-4. [Workflow: Existing Project](#-workflow-existing-project)
-5. [Workflow: Changes/Iterations](#-workflow-changesiterations)
-6. [Validation Checklist](#-validation-checklist)
-7. [Directory Structure](#-directory-structure)
-
----
-
-## 🎯 Framework Philosophy
-
-This framework is designed to ensure all AI-developed projects follow:
-
-- ✅ **Best coding practices** from the start
-- ✅ **Maintainable** and scalable architecture
-- ✅ **Complete and up-to-date** documentation
-- ✅ **Clear specifications** through OpenSpec
-- ✅ **Systematic debugging** of problems
-- ✅ **Automated change history**
-
-> **Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
-
----
+--- YOU SHOULD FOLLOW THIS EXACT WORKFLOW HERE, DONT SKIP STEPS, DONT CHANGE THE ORDER OF THE WORKFLOW, DONT SKIP SKILLS, DONT SKIP PHASES, DONT SKIP ANYTHING, JUST FOLLOW THE WORKFLOW EXACTLY AS IT IS WRITTEN HERE
 
 ## 🛠️ Available Skills
 
@@ -53,6 +11,17 @@ This framework is designed to ensure all AI-developed projects follow:
 | `secure-coding-cybersecurity` | Detects and prevents security vulnerabilities (SQLi, XSS, command injection, hardcoded secrets). Follows OWASP Top 10 standards. | Secure code validation |
 | `code-maintainability` | Analyzes code maintainability: duplication, documentation, error handling, naming conventions, SOLID architecture, performance. | Refactoring and standards |
 | `error-handling-patterns` | Error handling patterns in multiple languages: exceptions, Result types, retry, circuit breaker, graceful degradation. | Application resilience |
+| `performance-optimizer` | Methodologies for measuring, profiling, and optimizing code (caching, algorithm complexity, resource usage). | Performance Engineering |
+| `test-generator` | Generate comprehensive test suites (Unit, Integration, E2E) ensuring requirements are met. | Test Driven Development |
+
+### Main Consistency & Quality Skills
+
+| Skill | Description | Primary Use |
+|-------|-------------|---------------|
+| `project-constitution` | Manage the project's core principles and ensuring alignment. | Project Governance |
+| `requirement-checklist` | Generate quality control checklists for requirements (unit tests for specs). | Requirements Quality |
+| `spec-analysis` | Analyze consistency across Spec, Plan, and Tasks. | Consistency Check |
+| `spec-clarification` | Interactively clarify specific sections of the spec. | Ambiguity Resolution |
 
 ### Planning and Design Skills
 
@@ -82,6 +51,7 @@ This framework is designed to ensure all AI-developed projects follow:
 | Skill | Description | Primary Use |
 |-------|-------------|---------------|
 | `project-index` | Generates structured project documentation: structure analysis, domains, agent guides. | Indexing and context |
+| `sync-index` | Keep project documentation (`project-index` and sub-skills) in sync with codebase changes. | Documentation Sync |
 | `systematic-debugging` | Structured debugging in 4 phases: root cause investigation, pattern analysis, hypothesis, implementation. | Problem resolution |
 | `changelog-generator` | Creates automated changelogs from git commits, translating technical to user language. | Version history |
 | `skill-writer` | Guide to create new skills for Claude Code with correct structure and frontmatter. | Create new skills |
@@ -103,362 +73,120 @@ When starting a project **from scratch**, follow this mandatory workflow:
              │
              ▼
     ┌──────────────────────────────────────────────┐
-    │  PHASE 1: FOUNDATIONS (Mandatory)            │
-    │                                              │
-    │  1. secure-coding-cybersecurity              │
+    │  PHASE 1: FOUNDATIONS & GOVERNANCE           │
+    │  1. project-constitution                     │
+    │     └─ Define core principles                │
+    │  2. secure-coding-cybersecurity              │
     │     └─ Establish security guidelines         │
-    │                                              │
-    │  2. code-maintainability                     │
+    │  3. code-maintainability                     │
     │     └─ Define quality standards              │
-    │                                              │
-    │  3. brainstorming                            │
-    │     └─ Architecture and design decisions     │
     └────────────────────┬─────────────────────────┘
                          │
                          ▼
     ┌──────────────────────────────────────────────┐
-    │  PHASE 2: SPECIFICATION (Mandatory)          │
-    │                                              │
-    │  4. openspec-new-change                      │
-    │     └─ Create change with proposal           │
-    │                                              │
-    │  5. openspec-continue-change                 │
-    │     └─ Create specs, design, tasks           │
-    │        (or use openspec-ff-change)           │
+    │  PHASE 2: DISCOVERY & PLANNING               │
+    │  4. brainstorming                            │
+    │     └─ Architecture/Idea generation          │
+    │  5. openspec-new-change                      │
+    │     └─ Create proposal                       │
+    │  6. spec-clarification (CRITICAL)            │
+    │     └─ Refine requirements interactively     │
+    │  7. openspec-continue-change                 │
+    │     └─ Draft Specs, Design, Tasks            │
+    │  8. requirement-checklist                    │
+    │     └─ "Unit test" the specs                 │
+    │  9. spec-analysis                            │
+    │     └─ Verify Spec/Plan consistency          │
     └────────────────────┬─────────────────────────┘
                          │
                          ▼
     ┌──────────────────────────────────────────────┐
     │  PHASE 3: IMPLEMENTATION                     │
-    │                                              │
-    │  6. openspec-apply-change                    │
-    │     └─ Implement the tasks                   │
+    │  10. test-generator                          │
+    │      └─ TDD: Write tests first               │
+    │  11. openspec-apply-change                   │
+    │      └─ Implement code to pass tests         │
+    │  12. performance-optimizer                   │
+    │      └─ Optimize critical paths              │
     └────────────────────┬─────────────────────────┘
                          │
                          ▼
     ┌──────────────────────────────────────────────┐
-    │  PHASE 4: VALIDATION AND CLOSURE             │
-    │                                              │
-    │  7. systematic-debugging                     │
-    │     └─ Verify no errors                      │
-    │                                              │
-    │  8. openspec-verify-change                   │
-    │     └─ Validate against specs                │
-    │                                              │
-    │  9. changelog-generator                      │
-    │     └─ Generate in changelogs/by-ai/         │
-    │                                              │
-    │  10. openspec-archive-change                 │
+    │  PHASE 4: VALIDATION & CLOSURE               │
+    │  13. systematic-debugging                    │
+    │      └─ Resolve any issues                   │
+    │  14. openspec-verify-change                  │
+    │      └─ Validate against initial specs       │
+    │  15. sync-index                              │
+    │      └─ Update project docs                  │
+    │  16. openspec-archive-change                 │
     │      └─ Archive the change                   │
     └──────────────────────────────────────────────┘
 ```
 
-### Phase Descriptions - New Project
-
-| Phase | Skill | Description | Expected Output |
-|------|-------|-------------|-----------------|
-| 1 | `secure-coding-cybersecurity` | Establish security guidelines: input validation, sanitization, injection prevention, secrets handling | `.agents/security-guidelines.md` |
-| 2 | `code-maintainability` | Define conventions: naming, folder structure, design patterns, DRY, testing | `.agents/maintainability-rules.md` |
-| 3 | `brainstorming` | Generate architecture ideas, question approach, explore alternatives | `.agents/architecture-decisions.md` |
-| 4 | `openspec-new-change` | Create change with proposal (why, what changes, capabilities) | `openspec/changes/<name>/proposal.md` |
-| 5 | `openspec-continue-change` | Create specs (WHEN/THEN requirements), design (technical decisions), tasks (checklist) | Complete OpenSpec artifacts |
-| 6 | `openspec-apply-change` | Implement code according to specs and tasks | Functional code |
-| 7 | `systematic-debugging` | Structured debugging: investigate root cause, don't guess | Validation report |
-| 8 | `openspec-verify-change` | Verify completeness, correctness, and coherence | Verification report |
-| 9 | `changelog-generator` | Document changes in user language | `changelogs/by-ai/[date]-[feature].md` |
-| 10 | `openspec-archive-change` | Move change to archive with date | `openspec/changes/archive/YYYY-MM-DD-<name>/` |
-
 ---
 
-## 🔍 Workflow: Existing Project
+## 🔄 Workflow: Existing Project
 
-When working on an **already created** project that does NOT have `.md` documentation files:
+When working on an **existing codebase** (adding features, fixing bugs, refactoring):
 
 ```
 ┌─────────────────────────────────────────────────────────────────────────────────┐
-│                        WORKFLOW: EXISTING PROJECT (NO DOCS)                      │
+│                        WORKFLOW: EXISTING PROJECT                                │
 └─────────────────────────────────────────────────────────────────────────────────┘
 
-    ┌─────────────────────────────────────────────────────────────────────────┐
-    │                                                                          │
-    │   ⚠️  CHECK: No documentation .md files exist in                         │
-    │       .agents/ or openspec/                                              │
-    │                                                                          │
-    └────────────────────────────────────────────────────┬─────────────────────┘
-                                                         │
-                                                         ▼
-    ┌─────────────────────────────────────────────────────────────────────────┐
-    │                                                                          │
-    │   🔄 STEP 0: project-index                                               │
-    │   Generate complete documentation for existing project                   │
-    │   ├─ Analyze folder structure                                            │
-    │   ├─ Identify domains (UI, Backend, DB, etc.)                            │
-    │   ├─ Create specific sub-skills per domain                               │
-    │   └─ Generate agent-guidance files                                       │
-    │                                                                          │
-    │   Output:                                                                │
-    │   ├─ .agents/project-index.md                                            │
-    │   ├─ .agents/agent-<domain>.md (in each folder)                          │
-    │   └─ .claude/skills/project-index-<domain>/SKILL.md                      │
-    │                                                                          │
-    └─────────────────────────────────────────────────────────────────────────┘
-```
-
-### Post-Indexing
-
-Once the project is indexed, continue with the [Changes Workflow](#-workflow-changesiterations).
-
----
-
-## 🔄 Workflow: Changes/Iterations
-
-For **each change or new feature** in an already documented project:
-
-```
-┌─────────────────────────────────────────────────────────────────────────────────┐
-│                           WORKFLOW: CHANGES AND ITERATIONS                       │
-└─────────────────────────────────────────────────────────────────────────────────┘
-
-    ┌─────────────────────────┐
-    │   START CHANGE          │
-    └────────┬────────────────┘
+    ┌─────────────────┐
+    │  START CHANGE   │
+    └────────┬────────┘
              │
              ▼
-    ┌─────────────────────────┐     ┌──────────────────────────────────────────┐
-    │  1. openspec-explore    │────▶│  2. brainstorming                        │
-    │  (Explore current       │     │  (Based on exploration:                  │
-    │   code and structure)   │     │   - Generate ideas                       │
-    └─────────────────────────┘     │   - Suggest improvements                 │
-                                    │   - Ask key questions to user)           │
-                                    └─────────────────┬────────────────────────┘
-                                                      │
-                                                      ▼
-    ┌─────────────────────────┐     ┌──────────────────────────────────────────┐
-    │  3. openspec-new        │────▶│  4. openspec-continue / ff               │
-    │  (Create specification  │     │  (Create specs, design, tasks)           │
-    │   for change/feature)   │     └─────────────────┬────────────────────────┘
-    └─────────────────────────┘                       │
-                                                      ▼
-    ┌─────────────────────────┐     ┌──────────────────────────────────────────┐
-    │  5. openspec-apply      │────▶│  6. systematic-debugging                 │
-    │  (Implement changes     │     │  (Verify no errors,                      │
-    │   according to tasks)   │     │   validate patterns)                     │
-    └─────────────────────────┘     └─────────────────┬────────────────────────┘
-                                                      │
-                                                      ▼
-    ┌─────────────────────────┐     ┌──────────────────────────────────────────┐
-    │  7. openspec-verify     │────▶│  8. changelog-generator                  │
-    │  (Verify against        │     │  (Generate change record                 │
-    │   specs and design)     │     │   in changelogs/by-ai/)                  │
-    └─────────────────────────┘     └─────────────────┬────────────────────────┘
-                                                      │
-                                                      ▼
-    ┌─────────────────────────┐     ┌──────────────────────────────────────────┐
-    │  9. openspec-archive    │────▶│  10. openspec-sync-specs (optional)      │
-    │  (Archive completed     │     │  (Sync specs to main)                    │
-    │   change)               │     └──────────────────────────────────────────┘
-    └─────────────────────────┘
-                                                      │
-                                                      ▼
-    ┌─────────────────────────────────────────────────────────────────────────┐
-    │                                                                          │
-    │   ✅ CHANGE COMPLETED AND DOCUMENTED                                    │
-    │                                                                          │
-    └─────────────────────────────────────────────────────────────────────────┘
-```
-
-### Phase Descriptions - Changes/Iterations
-
-| Phase | Skill | Description | Required Input | Expected Output |
-|------|-------|-------------|-----------------|-----------------|
-| 1 | `openspec-explore` | Analyze current code state, identify dependencies and modification points | Change request context | Impact report in `.agents/exploration-report.md` |
-| 2 | `brainstorming` | Generate ideas based on exploration, suggest alternatives, ask user questions | Exploration report | `.agents/brainstorming-session.md` with decisions |
-| 3 | `openspec-new-change` | Create change container with initial proposal | Brainstorming decisions | `openspec/changes/<name>/proposal.md` |
-| 4 | `openspec-continue-change` or `openspec-ff-change` | Create specs, design, and tasks | Approved proposal | Complete OpenSpec artifacts |
-| 5 | `openspec-apply-change` | Implement tasks as described | Tasks ready | Modified code following specs |
-| 6 | `systematic-debugging` | Validate no errors, verify applied patterns | Modified code | Validation report in `.agents/debug-report.md` |
-| 7 | `openspec-verify-change` | Verify implementation matches specs and design | Artifacts + code | Verification report |
-| 8 | `changelog-generator` | Document change in history | Implemented feature | `changelogs/by-ai/[YYYY-MM-DD]-[feature].md` |
-| 9 | `openspec-archive-change` | Archive completed change | Change ready | `openspec/changes/archive/YYYY-MM-DD-<name>/` |
-| 10 | `openspec-sync-specs` (optional) | Synchronize delta specs to main specs | Delta specs | Main specs updated |
-
----
-
-## ✅ Validation Checklist
-
-Before considering any task as **completed**, verify:
-
-```
-╔═══════════════════════════════════════════════════════════════════════════════════╗
-║                              MANDATORY CHECKLIST                                   ║
-╠═══════════════════════════════════════════════════════════════════════════════════╣
-║                                                                                    ║
-║  □ Security                                                                        ║
-║    └─ □ secure-coding-cybersecurity executed                                     ║
-║    └─ □ No known vulnerabilities (SQL injection, XSS, etc.)                       ║
-║    └─ □ Inputs validated and sanitized                                            ║
-║    └─ □ Secrets/keys not hardcoded                                                ║
-║    └─ □ No eval() or dynamic code execution with user input                       ║
-║                                                                                    ║
-║  □ Maintainability                                                                 ║
-║    └─ □ code-maintainability executed                                            ║
-║    └─ □ Code follows project conventions                                          ║
-║    └─ □ Functions/classes have single responsibility                              ║
-║    └─ □ Descriptive and semantic names                                            ║
-║    └─ □ No duplicate code (DRY principle)                                         ║
-║    └─ □ Documentation explains "why", not "what"                                  ║
-║                                                                                    ║
-║  □ Error Handling                                                                  ║
-║    └─ □ error-handling-patterns applied                                           ║
-║    └─ □ All errors handled gracefully                                             ║
-║    └─ □ Edge cases covered (null, empty, boundaries)                              ║
-║                                                                                    ║
-║  □ Specification (OpenSpec)                                                        ║
-║    └─ □ Change created with proposal, specs, design, tasks                        ║
-║    └─ □ Implementation matches specification                                      ║
-║    └─ □ All WHEN/THEN scenarios implemented                                       ║
-║    └─ □ Design decisions documented                                               ║
-║                                                                                    ║
-║  □ Implementation                                                                  ║
-║    └─ □ All tasks marked complete [- [x]]                                         ║
-║    └─ □ Code tested and functional                                                ║
-║    └─ □ No console.logs or debug code                                             ║
-║                                                                                    ║
-║  □ Validation                                                                      ║
-║    └─ □ systematic-debugging executed without critical errors                     ║
-║    └─ □ openspec-verify-change passed (or reviewed)                               ║
-║    └─ □ Design patterns correctly applied                                         ║
-║                                                                                    ║
-║  □ Documentation                                                                   ║
-║    └─ □ Project index updated if structure changed                                ║
-║    └─ □ Changelog generated in changelogs/by-ai/                                  ║
-║    └─ □ README updated if necessary                                               ║
-║                                                                                    ║
-║  □ Closure                                                                         ║
-║    └─ □ Change archived with openspec-archive-change                              ║
-║    └─ □ Delta specs synchronized (if applicable)                                  ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
-
----
-
-## 📁 Directory Structure
-
-```
-project/
-│
-├── 📂 .agents/                    # AI-generated documentation
-│   ├── security-guidelines.md     # Security practices
-│   ├── maintainability-rules.md   # Maintainability rules
-│   ├── architecture-decisions.md  # Architecture decisions
-│   ├── project-index.md           # Complete project index
-│   ├── exploration-report.md      # Exploration reports
-│   ├── brainstorming-session.md   # Brainstorming sessions
-│   ├── debug-report.md            # Debugging reports
-│   └── agent-<domain>.md          # Per-domain guides (e.g., agent-ui.md)
-│
-├── 📂 .claude/                    # Project-specific skills
-│   └── skills/
-│       └── project-index-<domain>/
-│           └── SKILL.md           # Domain-specific skills
-│
-├── 📂 .openspec/                  # Formal specifications (OpenSpec)
-│   ├── specs/                     # Main specifications
-│   │   └── <capability>/
-│   │       └── spec.md
-│   └── changes/                   # Active changes
-│       ├── <change-name>/
-│       │   ├── proposal.md        # Why and what changes
-│       │   ├── design.md          # How to build it
-│       │   ├── tasks.md           # Implementation checklist
-│       │   └── specs/             # Delta specs
-│       │       └── <capability>/
-│       │           └── spec.md
-│       └── archive/               # Completed changes
-│           └── YYYY-MM-DD-<name>/
-│
-├── 📂 changelogs/                 # Change history
-│   └── by-ai/                     # AI-generated changelogs
-│       └── YYYY-MM-DD-feature.md
-│
-└── [project source code]
-```
-
----
-
-## 🎓 Quick Usage
-
-### To start a new project:
-```
-1. Execute: secure-coding-cybersecurity
-2. Execute: code-maintainability
-3. Execute: brainstorming
-4. Execute: openspec-new-change (or openspec-ff-change for quick mode)
-5. Execute: openspec-continue-change (create specs, design, tasks)
-6. Execute: openspec-apply-change
-7. Execute: systematic-debugging
-8. Execute: openspec-verify-change
-9. Execute: changelog-generator
-10. Execute: openspec-archive-change
-```
-
-### To modify an existing project:
-```
-1. Check if documentation exists (.agents/, openspec/)
-   └─ If NOT exists → Execute: project-index
-   
-2. Execute: openspec-explore
-3. Execute: brainstorming
-4. Execute: openspec-new-change (create change)
-5. Execute: openspec-continue-change (complete artifacts)
-6. Execute: openspec-apply-change (implement)
-7. Execute: systematic-debugging (validate)
-8. Execute: openspec-verify-change (verify against specs)
-9. Execute: changelog-generator
-10. Execute: openspec-archive-change
-```
-
-### Quick OpenSpec commands:
-```
-/opsx:explore        - Explore before implementing
-/opsx:new <name>     - Create new change step by step
-/opsx:ff <name>      - Fast-forward (create all quickly)
-/opsx:continue       - Continue existing change
-/opsx:apply          - Implement tasks
-/opsx:verify         - Verify implementation
-/opsx:archive        - Archive completed change
-/opsx:onboard        - OpenSpec tutorial
-```
-
----
-
-## 📌 Important Notes
-
-> **⚠️ NEVER skip workflow steps.** Each skill exists to ensure quality.
-
-> **📝 Documentation = Code.** If not documented in OpenSpec, it's not done.
-
-> **🔒 Security first.** Always execute secure-coding-cybersecurity before any implementation.
-
-> **🧠 Brainstorming is mandatory.** Never implement without questioning the approach first.
-
-> **✅ Validation before commit.** Always execute systematic-debugging and openspec-verify before finishing.
-
-> **📦 One change = One feature.** Don't mix multiple features in a single change.
-
-> **🔄 Sync specs.** After archiving, synchronize delta specs to main specs.
-
----
-
-```
-╔═══════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                    ║
-║           "Well-specified code is well-implemented code"                           ║
-║                                                                                    ║
-║                         Framework AGENTS.md v2.0                                   ║
-║                                                                                    ║
-║              22 Skills Available | OpenSpec Workflow Integrated                    ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
+    ┌──────────────────────────────────────────────┐
+    │  PHASE 1: CONTEXT & ANALYSIS                 │
+    │  1. project-index (if needed)                │
+    │     └─ Map current system                    │
+    │  2. openspec-explore                         │
+    │     └─ Deep dive into relevant modules       │
+    │  3. brainstorming                            │
+    │     └─ Ideate on feature/fix                 │
+    └────────────────────┬─────────────────────────┘
+                         │
+                         ▼
+    ┌──────────────────────────────────────────────┐
+    │  PHASE 2: REQUIREMENTS & PLANNING            │
+    │  4. openspec-new-change                      │
+    │     └─ Initialize change artifact            │
+    │  5. spec-clarification                       │
+    │     └─ CLARIFY requirements first            │
+    │  6. requirement-checklist                    │
+    │     └─ Validate requirements                 │
+    │  7. openspec-continue-change                 │
+    │     └─ Draft Specs, Design, Tasks            │
+    │  8. spec-analysis                            │
+    │     └─ Check consistency with existing       │
+    └────────────────────┬─────────────────────────┘
+                         │
+                         ▼
+    ┌──────────────────────────────────────────────┐
+    │  PHASE 3: TEST-DRIVEN IMPLEMENTATION         │
+    │  9. test-generator                           │
+    │     └─ Generate tests for new feature        │
+    │  10. openspec-apply-change                   │
+    │      └─ Implement code                       │
+    │  11. secure-coding-cybersecurity             │
+    │      └─ Audit new code                       │
+    └────────────────────┬─────────────────────────┘
+                         │
+                         ▼
+    ┌──────────────────────────────────────────────┐
+    │  PHASE 4: OPTIMIZATION & VERIFICATION        │
+    │  12. systematic-debugging                    │
+    │      └─ Fix regressions                      │
+    │  13. performance-optimizer                   │
+    │      └─ Ensure no perf degradation           │
+    │  14. openspec-verify-change                  │
+    │      └─ Final verification                   │
+    │  15. sync-index (IMPORTANT)                  │
+    │      └─ Update docs with new changes         │
+    │  16. openspec-archive-change                 │
+    │      └─ Archive change                       │
+    └──────────────────────────────────────────────┘

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-framework",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Agentic Coding Framework - Multi-assistant configuration system with OpenSpec workflows",
   "main": "src/index.js",
   "exports": {
@@ -46,6 +46,7 @@
     "commander": "^12.1.0",
     "gradient-string": "^3.0.0",
     "inquirer": "^12.3.2",
+    "js-yaml": "^4.1.1",
     "nanospinner": "^1.2.2",
     "tar": "^7.5.7"
   },

package/src/cli.js

@@ -6,6 +6,7 @@ import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { initCommand } from './commands/init.js';
 import { updateCommand } from './commands/update.js';
+import { specCommand } from './commands/spec.js';
 import { showBanner } from './ui/banner.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -36,4 +37,6 @@ program
     await updateCommand(opts);
   });
 
+program.addCommand(specCommand());
+
 program.parse();

package/src/commands/init.js

@@ -28,7 +28,6 @@ import {
 } from '../services/installer.js';
 import { downloadWithSpinner, cleanupTempDir } from '../services/github-sync.js';
 import {
-  matrixRain,
   scanAnimation,
   animatedSeparator,
   revealList,
@@ -228,8 +227,6 @@ export async function initCommand(options = {}) {
     await scanAnimation('Indexing available modules', 1000);
     console.log();
 
-    await matrixRain(1800);
-
     let folders;
     try {
       folders = await getSelectableModules(frameworkPath);