AngelEyes Agentic Development Kit for Claude Code
AE-ADK is a personal fork of moai-adk, optimized for single-developer workflows. It extends Claude Code with AI agent orchestration, automated quality gates, and a SPEC-driven development pipeline.
Built as a single Go binary -- zero dependencies, instant startup on Windows, macOS, and Linux.
- SPEC-Driven Workflow -- Plan requirements, implement with TDD/DDD, sync documentation in one pipeline
- AI Agent Orchestration -- Specialized agents for backend, frontend, security, testing, and more
- Automated Quality Gates -- TRUST 5 framework enforces test coverage, security, and code style
- Cross-Platform --
ae win/ae macfor seamless platform switching with PATH auto-reconfiguration - Self-Updating -- Built-in binary update with checksum verification and automatic rollback
- Hook System -- Pre/post tool hooks for formatting, linting, and security scanning
curl -fsSL https://raw.githubusercontent.com/AngeleyesTrue/ae-adk/main/install.sh | bashirm https://raw.githubusercontent.com/AngeleyesTrue/ae-adk/main/install.ps1 | iexgit clone https://github.com/AngeleyesTrue/ae-adk.git
cd ae-adk && make buildPrebuilt binaries are available on the Releases page.
# 1. Initialize a project
ae init my-project
# 2. Start developing with Claude Code
/ae plan "Add user authentication" # Create SPEC document
/ae run SPEC-AUTH-001 # Implement with TDD/DDD
/ae sync SPEC-AUTH-001 # Generate docs & create PRgraph LR
A["ae plan"] -->|SPEC| B["ae run"]
B -->|Code + Tests| C["ae sync"]
C -->|Docs + PR| D["Done"]
style A fill:#E3F2FD,stroke:#1565C0
style B fill:#E8F5E9,stroke:#2E7D32
style C fill:#FFF3E0,stroke:#E65100
style D fill:#F3E5F5,stroke:#7B1FA2
| Command | Description |
|---|---|
ae init |
Interactive project setup with language/framework auto-detection |
ae update |
Update binary with rollback support |
ae doctor |
System health diagnosis |
ae win |
Switch to Windows platform (PATH + diagnostics) |
ae mac |
Switch to macOS platform (PATH + diagnostics) |
ae worktree |
Git worktree management for parallel development |
ae version |
Display version, commit, and build date |
| Command | Purpose |
|---|---|
/ae plan "description" |
Create SPEC document (EARS format) |
/ae run SPEC-XXX |
TDD/DDD implementation |
/ae sync |
Documentation sync + PR creation |
/ae fix |
Auto-fix LSP errors and lint issues |
/ae loop |
Iterative fix until all errors resolved |
/ae review |
Multi-perspective code review |
/ae coverage |
Test coverage analysis + gap filling |
/ae mx |
Add @MX code annotations for AI context |
/ae clean |
Dead code identification and removal |
/ae agency |
AI Agency creative production pipeline |
AE-ADK automatically selects the optimal methodology based on your project state:
flowchart TD
A["Project Analysis"] --> B{"Test Coverage?"}
B -->|">= 10%"| C["TDD: RED -> GREEN -> REFACTOR"]
B -->|"< 10%"| D["DDD: ANALYZE -> PRESERVE -> IMPROVE"]
style C fill:#4CAF50,color:#fff
style D fill:#2196F3,color:#fff
| Methodology | Cycle | Best For |
|---|---|---|
| TDD (default) | Write test -> Implement -> Refactor | New projects, features |
| DDD | Analyze code -> Add tests -> Improve | Legacy code with low coverage |
Every code change is validated against five criteria:
| Gate | Meaning | Threshold |
|---|---|---|
| Tested | Test coverage | 85%+ |
| Readable | Code clarity | 0 lint errors |
| Unified | Style consistency | Consistent formatting |
| Secured | Security | OWASP compliance |
| Trackable | Traceability | Conventional commits |
make build # Build binary
make test # Run tests
make lint # Run linter
make coverage # Generate coverage report$ go test ./...
ok github.com/AngeleyesTrue/ae-adk/internal/cli 4.2s
ok github.com/AngeleyesTrue/ae-adk/internal/hook 5.5s
ok github.com/AngeleyesTrue/ae-adk/internal/platform 2.1s coverage: 97.8%
ok github.com/AngeleyesTrue/ae-adk/internal/update 4.1s
ok github.com/AngeleyesTrue/ae-adk/internal/template 2.0s
ok github.com/AngeleyesTrue/ae-adk/pkg/version 1.2s
...
ok 34/35 packages passed
$ goreleaser release --clean
-> windows/amd64 ae-adk_1.0.1_windows_amd64.zip
-> windows/arm64 ae-adk_1.0.1_windows_arm64.zip
-> darwin/amd64 ae-adk_1.0.1_darwin_amd64.tar.gz
-> darwin/arm64 ae-adk_1.0.1_darwin_arm64.tar.gz
-> linux/amd64 ae-adk_1.0.1_linux_amd64.tar.gz
-> linux/arm64 ae-adk_1.0.1_linux_arm64.tar.gz
ae-adk/
├── cmd/ae/ # CLI entry point
├── internal/
│ ├── cli/ # Command handlers (Cobra)
│ ├── hook/ # Claude Code hook system
│ ├── platform/ # Platform diagnostics (ae win/mac)
│ ├── update/ # Self-update mechanism
│ ├── template/ # Embedded template FS
│ └── lsp/ # LSP quality gates
├── pkg/version/ # Build-time version injection
├── install.ps1 # Windows installer
└── install.sh # macOS/Linux installer
Issues and pull requests are welcome. This is a personal development tool, but contributions that improve quality or add useful features are appreciated.
git checkout -b feature/my-feature
make test && make lint # Ensure quality gates pass
git commit -m "feat: description" # Conventional commits