@alxyrgin/agent-forge 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +166 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +808 -0
- package/dist/index.js.map +1 -0
- package/package.json +61 -0
- package/templates/agents/core/analyst.md.ejs +56 -0
- package/templates/agents/core/architect.md.ejs +64 -0
- package/templates/agents/core/developer.md.ejs +54 -0
- package/templates/agents/core/doc-writer.md.ejs +50 -0
- package/templates/agents/core/progress-tracker.md.ejs +56 -0
- package/templates/agents/core/reviewer.md.ejs +52 -0
- package/templates/agents/core/security-auditor.md.ejs +51 -0
- package/templates/agents/core/unit-tester.md.ejs +56 -0
- package/templates/agents/extra/acceptance-tester.md.ejs +48 -0
- package/templates/agents/extra/integration-tester.md.ejs +49 -0
- package/templates/agents/extra/planner.md.ejs +89 -0
- package/templates/memory/active-context.md.ejs +26 -0
- package/templates/memory/decisions.md.ejs +20 -0
- package/templates/memory/patterns.md.ejs +45 -0
- package/templates/memory/progress.md.ejs +25 -0
- package/templates/memory/project-brief.md.ejs +36 -0
- package/templates/memory/tech-debt.md.ejs +27 -0
- package/templates/memory/tech-stack.md.ejs +23 -0
- package/templates/memory/troubleshooting.md.ejs +28 -0
- package/templates/root/CLAUDE.md.ejs +110 -0
- package/templates/root/settings.json.ejs +14 -0
- package/templates/rules/commit-conventions.md.ejs +35 -0
- package/templates/rules/development-cycle.md.ejs +54 -0
- package/templates/rules/testing-standards.md.ejs +25 -0
- package/templates/skills/core/complete-task/SKILL.md.ejs +37 -0
- package/templates/skills/core/end-session/SKILL.md.ejs +81 -0
- package/templates/skills/core/plan/SKILL.md.ejs +58 -0
- package/templates/skills/core/review/SKILL.md.ejs +29 -0
- package/templates/skills/core/start-session/SKILL.md.ejs +58 -0
- package/templates/skills/core/status/SKILL.md.ejs +38 -0
- package/templates/skills/core/take-task/SKILL.md.ejs +69 -0
- package/templates/tasks/tasks.json.ejs +7 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Aleksandr Yarygin
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
# agent-forge
|
|
2
|
+
|
|
3
|
+
AI-driven Development Framework for Claude Code.
|
|
4
|
+
|
|
5
|
+
Scaffold a complete development infrastructure with Memory Bank, specialized agents, skills, and development rules in any project.
|
|
6
|
+
|
|
7
|
+
## Quick Start
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx agent-forge init
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
This creates a full AI-driven development infrastructure in your project:
|
|
14
|
+
|
|
15
|
+
- **`.claude/`** — CLAUDE.md (Team Lead instructions), 8 agents, 7 skills, 3 rules
|
|
16
|
+
- **`dev-infra/memory/`** — 8 Memory Bank files for persistent context
|
|
17
|
+
- **`dev-infra/tasks/`** — Task tracking system (tasks.json)
|
|
18
|
+
- **`dev-infra/sessions/`** — Session logs
|
|
19
|
+
- **`dev-infra/tests/`** — Test structure (acceptance, PMI, results)
|
|
20
|
+
|
|
21
|
+
## How It Works
|
|
22
|
+
|
|
23
|
+
### Memory Bank
|
|
24
|
+
|
|
25
|
+
8 markdown files that persist context across sessions:
|
|
26
|
+
|
|
27
|
+
| File | Purpose |
|
|
28
|
+
|------|---------|
|
|
29
|
+
| `active-context.md` | Current session state, what's done, next steps |
|
|
30
|
+
| `progress.md` | Milestone progress, task statuses |
|
|
31
|
+
| `project-brief.md` | Project overview, team, stack |
|
|
32
|
+
| `decisions.md` | Architectural Decision Records (ADR) |
|
|
33
|
+
| `tech-stack.md` | Technology stack details |
|
|
34
|
+
| `tech-debt.md` | Technical debt registry |
|
|
35
|
+
| `patterns.md` | Code patterns and conventions |
|
|
36
|
+
| `troubleshooting.md` | Problem solutions log |
|
|
37
|
+
|
|
38
|
+
### Agents
|
|
39
|
+
|
|
40
|
+
Specialized AI agents, each with a specific role:
|
|
41
|
+
|
|
42
|
+
| Agent | Role |
|
|
43
|
+
|-------|------|
|
|
44
|
+
| `analyst` | Requirement analysis from docs |
|
|
45
|
+
| `architect` | Module architecture design |
|
|
46
|
+
| `developer` | Code implementation |
|
|
47
|
+
| `unit-tester` | Unit test writing and running |
|
|
48
|
+
| `reviewer` | Code quality review |
|
|
49
|
+
| `security-auditor` | Security and access control audit |
|
|
50
|
+
| `doc-writer` | Documentation generation |
|
|
51
|
+
| `progress-tracker` | Memory bank and task updates |
|
|
52
|
+
|
|
53
|
+
**Full preset** adds: `planner`, `integration-tester`, `acceptance-tester`
|
|
54
|
+
|
|
55
|
+
**Minimal preset** includes only: `analyst`, `developer`, `unit-tester`, `reviewer`
|
|
56
|
+
|
|
57
|
+
### Skills (Slash Commands)
|
|
58
|
+
|
|
59
|
+
| Command | Description |
|
|
60
|
+
|---------|-------------|
|
|
61
|
+
| `/start-session` | Begin work: sync repo, load context, show progress |
|
|
62
|
+
| `/end-session` | Save context, create session log, commit & push |
|
|
63
|
+
| `/take-task [id]` | Full development cycle: analysis -> code -> test -> review |
|
|
64
|
+
| `/complete-task [id]` | Verify task completion, update progress |
|
|
65
|
+
| `/status` | Show project status, deadlines, blockers |
|
|
66
|
+
| `/plan [mode]` | Plan/replan/validate tasks from documentation |
|
|
67
|
+
| `/review [file]` | Code review for file or task |
|
|
68
|
+
|
|
69
|
+
### Development Cycle
|
|
70
|
+
|
|
71
|
+
When you run `/take-task`, the system automatically orchestrates:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
[1] ANALYSIS — analyst reads docs, finds requirements
|
|
75
|
+
[2] DISCOVERY — clarifying questions if unclear
|
|
76
|
+
[3] PLAN — architect designs module structure
|
|
77
|
+
[4] CODE — developer writes code
|
|
78
|
+
[5] TESTS — unit-tester writes tests (>=80% coverage)
|
|
79
|
+
[6] REVIEW — reviewer checks quality and security
|
|
80
|
+
[7] FIXATION — update tasks, progress, propose commit
|
|
81
|
+
[8] TECH-DEBT — record any deviations
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## Configuration
|
|
85
|
+
|
|
86
|
+
### Agent Presets
|
|
87
|
+
|
|
88
|
+
- **Core** (default, 8 agents) — balanced set for most projects
|
|
89
|
+
- **Full** (11 agents) — adds planner, integration tester, acceptance tester
|
|
90
|
+
- **Minimal** (4 agents) — analyst, developer, unit-tester, reviewer
|
|
91
|
+
|
|
92
|
+
### Interactive Setup
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx agent-forge init
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
Prompts for:
|
|
99
|
+
- Project name and description
|
|
100
|
+
- Technology stack (Python/TypeScript/Go/Rust)
|
|
101
|
+
- Framework and test framework
|
|
102
|
+
- Team members (names, roles, emails)
|
|
103
|
+
- Milestones (optional)
|
|
104
|
+
- Agent preset (core/full/minimal)
|
|
105
|
+
- Commit style (standard/conventional)
|
|
106
|
+
|
|
107
|
+
### Non-interactive
|
|
108
|
+
|
|
109
|
+
```bash
|
|
110
|
+
npx agent-forge init --yes # Use defaults
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
## Commands
|
|
114
|
+
|
|
115
|
+
### `agent-forge init`
|
|
116
|
+
|
|
117
|
+
Initialize AI-driven development infrastructure.
|
|
118
|
+
|
|
119
|
+
Options:
|
|
120
|
+
- `--yes, -y` — skip prompts, use defaults
|
|
121
|
+
- `--overwrite` — overwrite existing files
|
|
122
|
+
|
|
123
|
+
### `agent-forge doctor`
|
|
124
|
+
|
|
125
|
+
Check integrity of the generated structure.
|
|
126
|
+
|
|
127
|
+
Verifies all expected files exist and are not empty.
|
|
128
|
+
|
|
129
|
+
## Generated Structure
|
|
130
|
+
|
|
131
|
+
```
|
|
132
|
+
your-project/
|
|
133
|
+
├── .claude/
|
|
134
|
+
│ ├── CLAUDE.md # Team Lead instructions
|
|
135
|
+
│ ├── settings.json # Claude Code hooks
|
|
136
|
+
│ ├── agents/ # 4-11 specialized agents
|
|
137
|
+
│ │ ├── analyst.md
|
|
138
|
+
│ │ ├── architect.md
|
|
139
|
+
│ │ ├── developer.md
|
|
140
|
+
│ │ └── ...
|
|
141
|
+
│ ├── skills/ # 7 slash commands
|
|
142
|
+
│ │ ├── start-session/SKILL.md
|
|
143
|
+
│ │ ├── take-task/SKILL.md
|
|
144
|
+
│ │ └── ...
|
|
145
|
+
│ └── rules/ # 3 development standards
|
|
146
|
+
│ ├── commit-conventions.md
|
|
147
|
+
│ ├── development-cycle.md
|
|
148
|
+
│ └── testing-standards.md
|
|
149
|
+
├── dev-infra/
|
|
150
|
+
│ ├── memory/ # 8 Memory Bank files
|
|
151
|
+
│ │ ├── active-context.md
|
|
152
|
+
│ │ ├── progress.md
|
|
153
|
+
│ │ └── ...
|
|
154
|
+
│ ├── tasks/
|
|
155
|
+
│ │ └── tasks.json # Task tracking
|
|
156
|
+
│ ├── sessions/ # Session logs
|
|
157
|
+
│ └── tests/ # Test structure
|
|
158
|
+
│ ├── acceptance/
|
|
159
|
+
│ ├── pmi/
|
|
160
|
+
│ └── results/
|
|
161
|
+
└── .claude-forge.json # Manifest for doctor
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
## License
|
|
165
|
+
|
|
166
|
+
MIT
|
package/dist/index.d.ts
ADDED