ac-framework 1.3.0 → 1.5.0

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright © 2026 AF-Framework Contributors
+Copyright © 2026 AC-Framework Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/framework/{AGENTS.md → .agent/workflows/ac.md}

@@ -1,47 +1,4 @@
-# 🤖 AGENTS.md - AI Work Framework
-
-```
-╔══════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                          ║
-║    █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗                                  ║
-║   ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝                                  ║
-║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗                                  ║
-║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║                                  ║
-║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║                                  ║
-║   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝                                  ║
-║                                                                                          ║
-║                    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."*
-
+ **Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
 ---
 
 ## 🛠️ Available Skills
@@ -338,127 +295,4 @@ Before considering any task as **completed**, verify:
 ║    └─ □ 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                    ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
+╚═══════════════════════════════════════════════════════════════════════════════════╝

package/framework/{CLAUDE.md → .amazonq/prompts/ac.md}

@@ -1,47 +1,4 @@
-# 🤖 AGENTS.md - AI Work Framework
-
-```
-╔══════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                          ║
-║    █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗                                  ║
-║   ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝                                  ║
-║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗                                  ║
-║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║                                  ║
-║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║                                  ║
-║   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝                                  ║
-║                                                                                          ║
-║                    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."*
-
+ **Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
 ---
 
 ## 🛠️ Available Skills
@@ -338,127 +295,4 @@ Before considering any task as **completed**, verify:
 ║    └─ □ 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                    ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
+╚═══════════════════════════════════════════════════════════════════════════════════╝

package/framework/{GEMINI.md → .augment/commands/ac.md}

@@ -1,47 +1,4 @@
-# 🤖 AGENTS.md - AI Work Framework
-
-```
-╔══════════════════════════════════════════════════════════════════════════════════════════╗
-║                                                                                          ║
-║    █████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗                                  ║
-║   ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝                                  ║
-║   ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ███████╗                                  ║
-║   ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║                                  ║
-║   ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ███████║                                  ║
-║   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝                                  ║
-║                                                                                          ║
-║                    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."*
-
+ **Fundamental Principle**: *"Quality over speed. Documentation before code. Planning before execution."*
 ---
 
 ## 🛠️ Available Skills
@@ -338,127 +295,4 @@ Before considering any task as **completed**, verify:
 ║    └─ □ 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                    ║
-║                                                                                    ║
-╚═══════════════════════════════════════════════════════════════════════════════════╝
-```
+╚═══════════════════════════════════════════════════════════════════════════════════╝