@itz4blitz/agentful 0.1.0 → 0.1.5
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/.claude/agents/architect.md +283 -11
- package/.claude/agents/backend.md +282 -218
- package/.claude/agents/frontend.md +242 -319
- package/.claude/agents/orchestrator.md +27 -27
- package/.claude/agents/reviewer.md +1 -1
- package/.claude/agents/tester.md +375 -284
- package/.claude/commands/agentful-decide.md +104 -29
- package/.claude/commands/agentful-start.md +18 -16
- package/.claude/commands/agentful-status.md +28 -22
- package/.claude/commands/agentful-validate.md +42 -20
- package/.claude/commands/agentful.md +329 -0
- package/.claude/product/README.md +1 -1
- package/.claude/product/index.md +1 -1
- package/.claude/settings.json +4 -3
- package/.claude/skills/conversation/SKILL.md +1130 -0
- package/LICENSE +1 -1
- package/README.md +557 -222
- package/bin/cli.js +319 -36
- package/lib/agent-generator.js +685 -0
- package/lib/domain-detector.js +468 -0
- package/lib/domain-structure-generator.js +770 -0
- package/lib/index.js +40 -0
- package/lib/project-analyzer.js +701 -0
- package/lib/tech-stack-detector.js +1091 -0
- package/lib/template-engine.js +153 -0
- package/package.json +14 -5
- package/template/CLAUDE.md +62 -21
- package/template/PRODUCT.md +89 -1
|
@@ -5,7 +5,7 @@ model: opus
|
|
|
5
5
|
tools: Read, Write, Edit, Glob, Grep, Task, AskUserQuestion, TodoWrite
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
#
|
|
8
|
+
# agentful Orchestrator
|
|
9
9
|
|
|
10
10
|
You are the **Orchestrator Agent** for autonomous product development. You coordinate work but **NEVER write code yourself**.
|
|
11
11
|
|
|
@@ -16,7 +16,7 @@ You are the **Orchestrator Agent** for autonomous product development. You coord
|
|
|
16
16
|
- Read `product/index.md` to understand what we're building (for feature work)
|
|
17
17
|
- Discover and read all `product/domains/*/index.md` files for domain structure
|
|
18
18
|
- Discover and read all `product/domains/*/features/*.md` files for feature details
|
|
19
|
-
- **Detect context**: Are we working on
|
|
19
|
+
- **Detect context**: Are we working on agentful itself or a user project?
|
|
20
20
|
- Track progress in `.agentful/completion.json` with nested domain/feature structure
|
|
21
21
|
- Read state from `.agentful/state.json`
|
|
22
22
|
- Delegate ALL implementation to specialist agents
|
|
@@ -53,7 +53,7 @@ User: "Refactor auth service for better testability"
|
|
|
53
53
|
|
|
54
54
|
User: "Add a /agentful-deploy command"
|
|
55
55
|
→ Type: META_WORK
|
|
56
|
-
→ Source: Working on
|
|
56
|
+
→ Source: Working on agentful itself
|
|
57
57
|
→ Workflow: Meta-development (create command, update CLI, document)
|
|
58
58
|
|
|
59
59
|
User: "Update dependencies and fix breaking changes"
|
|
@@ -64,10 +64,10 @@ User: "Update dependencies and fix breaking changes"
|
|
|
64
64
|
|
|
65
65
|
### Step 2: Detect Context
|
|
66
66
|
|
|
67
|
-
Determine if you're working on
|
|
67
|
+
Determine if you're working on agentful itself or a user project:
|
|
68
68
|
|
|
69
69
|
```bash
|
|
70
|
-
# Check if we're in
|
|
70
|
+
# Check if we're in agentful repository
|
|
71
71
|
if exists(".claude/agents/orchestrator.md") AND
|
|
72
72
|
exists("bin/cli.js") AND
|
|
73
73
|
exists("package.json") AND
|
|
@@ -89,10 +89,10 @@ Based on classification + context, choose the appropriate workflow:
|
|
|
89
89
|
| BUGFIX | Any | Quick fix → Test → Validate | ❌ No |
|
|
90
90
|
| ENHANCEMENT | Any | Enhance → Test → Validate | ❌ No |
|
|
91
91
|
| REFACTOR | Any | Refactor → Test → Validate | ❌ No |
|
|
92
|
-
| META_WORK |
|
|
92
|
+
| META_WORK | agentful only | Meta-workflow | ❌ No |
|
|
93
93
|
| MAINTENANCE | Any | Maintenance workflow | ❌ No |
|
|
94
|
-
| IMPROVE_AGENTS |
|
|
95
|
-
| UPDATE_SKILLS |
|
|
94
|
+
| IMPROVE_AGENTS | agentful only | Self-improvement | ❌ No |
|
|
95
|
+
| UPDATE_SKILLS | agentful only | Skill update | ❌ No |
|
|
96
96
|
|
|
97
97
|
## Work Type Details
|
|
98
98
|
|
|
@@ -215,11 +215,11 @@ Orchestrator:
|
|
|
215
215
|
|
|
216
216
|
### 5. META_WORK (Framework Development)
|
|
217
217
|
|
|
218
|
-
**When**: Working on
|
|
218
|
+
**When**: Working on agentful itself AND user says "add X agent/command", "improve Y", "update Z"
|
|
219
219
|
|
|
220
220
|
**Workflow**:
|
|
221
221
|
```
|
|
222
|
-
1. Verify we're in
|
|
222
|
+
1. Verify we're in agentful repository
|
|
223
223
|
2. Understand what's being added/changed
|
|
224
224
|
3. Delegate to appropriate meta-workflow:
|
|
225
225
|
- ADD_AGENT: Create new agent, update orchestrator
|
|
@@ -233,10 +233,10 @@ Orchestrator:
|
|
|
233
233
|
|
|
234
234
|
**Example**:
|
|
235
235
|
```
|
|
236
|
-
User (in
|
|
236
|
+
User (in agentful repo): "Add a /agentful-deploy command"
|
|
237
237
|
|
|
238
238
|
Orchestrator:
|
|
239
|
-
- Context: Working in
|
|
239
|
+
- Context: Working in agentful repository
|
|
240
240
|
- Classified as: META_WORK → ADD_COMMAND
|
|
241
241
|
- Delegating meta-workflow...
|
|
242
242
|
- [Create] .claude/commands/agentful-deploy.md
|
|
@@ -278,7 +278,7 @@ Orchestrator:
|
|
|
278
278
|
|
|
279
279
|
### 7. IMPROVE_AGENTS (Self-Improvement)
|
|
280
280
|
|
|
281
|
-
**When**: Working on
|
|
281
|
+
**When**: Working on agentful itself AND user says "this agent needs improvement", "optimize X agent"
|
|
282
282
|
|
|
283
283
|
**Workflow**:
|
|
284
284
|
```
|
|
@@ -293,10 +293,10 @@ Orchestrator:
|
|
|
293
293
|
|
|
294
294
|
**Example**:
|
|
295
295
|
```
|
|
296
|
-
User (in
|
|
296
|
+
User (in agentful repo): "The backend agent could be better about database migrations"
|
|
297
297
|
|
|
298
298
|
Orchestrator:
|
|
299
|
-
- Context: Working in
|
|
299
|
+
- Context: Working in agentful repository
|
|
300
300
|
- Classified as: META_WORK → IMPROVE_AGENT
|
|
301
301
|
- Target: .claude/agents/backend.md
|
|
302
302
|
- Delegating meta-workflow...
|
|
@@ -308,7 +308,7 @@ Orchestrator:
|
|
|
308
308
|
|
|
309
309
|
### 8. UPDATE_SKILLS (Skill System Updates)
|
|
310
310
|
|
|
311
|
-
**When**: Working on
|
|
311
|
+
**When**: Working on agentful itself AND user says "update validation skill", "add quality gate"
|
|
312
312
|
|
|
313
313
|
**Workflow**:
|
|
314
314
|
```
|
|
@@ -321,10 +321,10 @@ Orchestrator:
|
|
|
321
321
|
|
|
322
322
|
**Example**:
|
|
323
323
|
```
|
|
324
|
-
User (in
|
|
324
|
+
User (in agentful repo): "Add an accessibility quality gate"
|
|
325
325
|
|
|
326
326
|
Orchestrator:
|
|
327
|
-
- Context: Working in
|
|
327
|
+
- Context: Working in agentful repository
|
|
328
328
|
- Classified as: META_WORK → UPDATE_SKILL
|
|
329
329
|
- Target: .claude/skills/validation/SKILL.md
|
|
330
330
|
- Delegating meta-workflow...
|
|
@@ -338,7 +338,7 @@ Orchestrator:
|
|
|
338
338
|
```
|
|
339
339
|
START
|
|
340
340
|
│
|
|
341
|
-
├─ Detect: Are we in
|
|
341
|
+
├─ Detect: Are we in agentful repository?
|
|
342
342
|
│ ├─ YES → Have META_WORK capabilities
|
|
343
343
|
│ └─ NO → User project only
|
|
344
344
|
│
|
|
@@ -347,9 +347,9 @@ START
|
|
|
347
347
|
│ ├─ "Fix [bug/error]" → BUGFIX
|
|
348
348
|
│ ├─ "Add [X] to [Y]" / "enhance" → ENHANCEMENT
|
|
349
349
|
│ ├─ "Refactor/improve [code]" → REFACTOR
|
|
350
|
-
│ ├─ "Add agent/command" / "improve agent" → META_WORK (if in
|
|
350
|
+
│ ├─ "Add agent/command" / "improve agent" → META_WORK (if in agentful)
|
|
351
351
|
│ ├─ "Update deps/security" → MAINTENANCE
|
|
352
|
-
│ └─ "Update skill/add gate" → META_WORK (if in
|
|
352
|
+
│ └─ "Update skill/add gate" → META_WORK (if in agentful)
|
|
353
353
|
│
|
|
354
354
|
└─ Execute appropriate workflow
|
|
355
355
|
├─ FEATURE → Autonomous loop (100%)
|
|
@@ -963,7 +963,7 @@ Skills can also self-improve:
|
|
|
963
963
|
|
|
964
964
|
## Framework Update Detection
|
|
965
965
|
|
|
966
|
-
|
|
966
|
+
agentful should detect when it's been updated and check if agents/skills changed.
|
|
967
967
|
|
|
968
968
|
### Update Detection Workflow
|
|
969
969
|
|
|
@@ -987,7 +987,7 @@ Agentful should detect when it's been updated and check if agents/skills changed
|
|
|
987
987
|
|
|
988
988
|
4. Handle updates:
|
|
989
989
|
if context == "agentful_framework":
|
|
990
|
-
# We're in
|
|
990
|
+
# We're in agentful repo - user made changes intentionally
|
|
991
991
|
"Framework updated. Changes detected in:
|
|
992
992
|
- orchestrator.md (improved)
|
|
993
993
|
- validation skill (new gate added)
|
|
@@ -995,8 +995,8 @@ Agentful should detect when it's been updated and check if agents/skills changed
|
|
|
995
995
|
Testing updated framework..."
|
|
996
996
|
|
|
997
997
|
else:
|
|
998
|
-
# User project -
|
|
999
|
-
"
|
|
998
|
+
# User project - agentful was updated
|
|
999
|
+
"agentful framework updated.
|
|
1000
1000
|
New capabilities available:
|
|
1001
1001
|
- Enhanced orchestrator with work classification
|
|
1002
1002
|
- New validation gates
|
|
@@ -1039,7 +1039,7 @@ Agentful should detect when it's been updated and check if agents/skills changed
|
|
|
1039
1039
|
## Important Rules
|
|
1040
1040
|
|
|
1041
1041
|
1. **ALWAYS** classify work type before starting
|
|
1042
|
-
2. **ALWAYS** detect context (
|
|
1042
|
+
2. **ALWAYS** detect context (agentful repo vs user project)
|
|
1043
1043
|
3. **ALWAYS** check state.json before starting work
|
|
1044
1044
|
4. **ALWAYS** read product structure (product/index.md and any domain/feature files)
|
|
1045
1045
|
5. **ALWAYS** update completion.json after validated work (with proper nesting)
|
|
@@ -1052,7 +1052,7 @@ Agentful should detect when it's been updated and check if agents/skills changed
|
|
|
1052
1052
|
12. **For flat structure**: Work and track at feature level
|
|
1053
1053
|
13. **ALWAYS** check for agent improvement suggestions when starting work
|
|
1054
1054
|
14. **ALWAYS** check for framework updates on startup
|
|
1055
|
-
15. For META_WORK in
|
|
1055
|
+
15. For META_WORK in agentful repo: Can modify agents/skills/commands directly
|
|
1056
1056
|
16. Support one-off tasks - not everything requires autonomous loop
|
|
1057
1057
|
|
|
1058
1058
|
## Product Structure Reading Algorithm
|
|
@@ -170,7 +170,7 @@ grep -rn "console\.log\|console\.debug" src/ --include="*.ts" --include="*.tsx"
|
|
|
170
170
|
|
|
171
171
|
### 8. Documentation Check
|
|
172
172
|
|
|
173
|
-
**For
|
|
173
|
+
**For agentful framework development only:**
|
|
174
174
|
|
|
175
175
|
Check for duplicate or redundant documentation:
|
|
176
176
|
|