@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.
Files changed (38) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +166 -0
  3. package/dist/index.d.ts +2 -0
  4. package/dist/index.js +808 -0
  5. package/dist/index.js.map +1 -0
  6. package/package.json +61 -0
  7. package/templates/agents/core/analyst.md.ejs +56 -0
  8. package/templates/agents/core/architect.md.ejs +64 -0
  9. package/templates/agents/core/developer.md.ejs +54 -0
  10. package/templates/agents/core/doc-writer.md.ejs +50 -0
  11. package/templates/agents/core/progress-tracker.md.ejs +56 -0
  12. package/templates/agents/core/reviewer.md.ejs +52 -0
  13. package/templates/agents/core/security-auditor.md.ejs +51 -0
  14. package/templates/agents/core/unit-tester.md.ejs +56 -0
  15. package/templates/agents/extra/acceptance-tester.md.ejs +48 -0
  16. package/templates/agents/extra/integration-tester.md.ejs +49 -0
  17. package/templates/agents/extra/planner.md.ejs +89 -0
  18. package/templates/memory/active-context.md.ejs +26 -0
  19. package/templates/memory/decisions.md.ejs +20 -0
  20. package/templates/memory/patterns.md.ejs +45 -0
  21. package/templates/memory/progress.md.ejs +25 -0
  22. package/templates/memory/project-brief.md.ejs +36 -0
  23. package/templates/memory/tech-debt.md.ejs +27 -0
  24. package/templates/memory/tech-stack.md.ejs +23 -0
  25. package/templates/memory/troubleshooting.md.ejs +28 -0
  26. package/templates/root/CLAUDE.md.ejs +110 -0
  27. package/templates/root/settings.json.ejs +14 -0
  28. package/templates/rules/commit-conventions.md.ejs +35 -0
  29. package/templates/rules/development-cycle.md.ejs +54 -0
  30. package/templates/rules/testing-standards.md.ejs +25 -0
  31. package/templates/skills/core/complete-task/SKILL.md.ejs +37 -0
  32. package/templates/skills/core/end-session/SKILL.md.ejs +81 -0
  33. package/templates/skills/core/plan/SKILL.md.ejs +58 -0
  34. package/templates/skills/core/review/SKILL.md.ejs +29 -0
  35. package/templates/skills/core/start-session/SKILL.md.ejs +58 -0
  36. package/templates/skills/core/status/SKILL.md.ejs +38 -0
  37. package/templates/skills/core/take-task/SKILL.md.ejs +69 -0
  38. 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
@@ -0,0 +1,2 @@
1
+
2
+ export { }