@lumenflow/cli 3.10.1 → 3.11.1
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/README.md +78 -74
- package/dist/docs-sync.js +24 -29
- package/dist/docs-sync.js.map +1 -1
- package/dist/init-scaffolding.js +2 -9
- package/dist/init-scaffolding.js.map +1 -1
- package/dist/init.js +7 -18
- package/dist/init.js.map +1 -1
- package/dist/onboarding-template-paths.js +19 -0
- package/dist/onboarding-template-paths.js.map +1 -0
- package/dist/public-manifest.js +2 -2
- package/dist/public-manifest.js.map +1 -1
- package/dist/sync-templates.js +12 -1
- package/dist/sync-templates.js.map +1 -1
- package/dist/template-directory-resolver.js +71 -0
- package/dist/template-directory-resolver.js.map +1 -0
- package/dist/wu-done-check.js +33 -13
- package/dist/wu-done-check.js.map +1 -1
- package/dist/wu-done.js +6 -5
- package/dist/wu-done.js.map +1 -1
- package/dist/wu-spawn-prompt-builders.js +96 -23
- package/dist/wu-spawn-prompt-builders.js.map +1 -1
- package/package.json +8 -8
- package/packs/sidekick/.turbo/turbo-build.log +1 -1
- package/packs/sidekick/package.json +1 -1
- package/packs/software-delivery/.turbo/turbo-build.log +1 -1
- package/packs/software-delivery/package.json +1 -1
- package/templates/core/.lumenflow/constraints.md.template +3 -3
- package/templates/core/LUMENFLOW.md.template +17 -17
- package/templates/core/UPGRADING.md.template +30 -11
- package/templates/core/ai/onboarding/agent-safety-card.md.template +15 -16
- package/templates/core/ai/onboarding/first-15-mins.md.template +80 -0
- package/templates/core/ai/onboarding/first-wu-mistakes.md.template +3 -3
- package/templates/core/ai/onboarding/initiative-orchestration.md.template +1 -1
- package/templates/core/ai/onboarding/lane-inference.md.template +64 -0
- package/templates/core/ai/onboarding/local-only.md.template +56 -0
- package/templates/core/ai/onboarding/quick-ref-commands.md.template +122 -92
- package/templates/core/ai/onboarding/starting-prompt.md.template +91 -46
- package/templates/core/ai/onboarding/vendor-support.md.template +14 -20
- package/templates/core/ai/onboarding/wu-create-checklist.md.template +31 -82
- package/templates/core/ai/onboarding/wu-sizing-guide.md.template +48 -0
- package/templates/vendors/claude/.claude/skills/bug-classification/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/code-quality/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/context-management/SKILL.md.template +3 -3
- package/templates/vendors/claude/.claude/skills/execution-memory/SKILL.md.template +1 -1
- package/templates/vendors/claude/.claude/skills/initiative-management/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/library-first/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/lumenflow-gates/SKILL.md.template +3 -3
- package/templates/vendors/claude/.claude/skills/multi-agent-coordination/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/tdd-workflow/SKILL.md.template +3 -3
- package/templates/vendors/claude/.claude/skills/worktree-discipline/SKILL.md.template +10 -10
- package/templates/vendors/claude/.claude/skills/wu-lifecycle/SKILL.md.template +3 -3
|
@@ -187,31 +187,25 @@ pnpm wu:claim --id WU-XXX --lane "<Lane>" --cloud
|
|
|
187
187
|
LUMENFLOW_CLOUD=1 pnpm wu:claim --id WU-XXX --lane "<Lane>"
|
|
188
188
|
```
|
|
189
189
|
|
|
190
|
-
|
|
191
|
-
|
|
190
|
+
Cloud activation is explicit-only. `--cloud` and `LUMENFLOW_CLOUD=1` are the only
|
|
191
|
+
runtime activation paths.
|
|
192
192
|
|
|
193
|
-
### Config
|
|
193
|
+
### Cloud Config Compatibility Fields
|
|
194
194
|
|
|
195
|
-
|
|
196
|
-
|
|
195
|
+
The workspace schema still carries `cloud.auto_detect` and `env_signals`, but they do
|
|
196
|
+
not activate cloud mode at runtime:
|
|
197
197
|
|
|
198
198
|
```yaml
|
|
199
199
|
cloud:
|
|
200
|
-
auto_detect:
|
|
201
|
-
env_signals:
|
|
202
|
-
- name: CI # presence check (any non-empty value)
|
|
203
|
-
- name: CODEX
|
|
204
|
-
- name: GITHUB_ACTIONS
|
|
205
|
-
equals: 'true' # exact match required
|
|
200
|
+
auto_detect: false
|
|
201
|
+
env_signals: []
|
|
206
202
|
```
|
|
207
203
|
|
|
208
204
|
**Key design decisions:**
|
|
209
205
|
|
|
210
|
-
-
|
|
211
|
-
-
|
|
212
|
-
-
|
|
213
|
-
matches (`name` + `equals`)
|
|
214
|
-
- Explicit activation always wins over auto-detection
|
|
206
|
+
- Runtime identity signals are intentionally ignored for activation
|
|
207
|
+
- Explicit activation always wins because it is the only activation path
|
|
208
|
+
- Config fields remain for compatibility, migration, and future policy metadata
|
|
215
209
|
|
|
216
210
|
### Cloud Lifecycle
|
|
217
211
|
|
|
@@ -225,10 +219,10 @@ cloud:
|
|
|
225
219
|
|
|
226
220
|
### Vendor-Specific Notes
|
|
227
221
|
|
|
228
|
-
- **Codex**: Set `LUMENFLOW_CLOUD=1`
|
|
229
|
-
- **Claude web**: Use `--cloud`
|
|
230
|
-
- **GitHub Actions**:
|
|
231
|
-
- **Antigravity**:
|
|
222
|
+
- **Codex**: Set `LUMENFLOW_CLOUD=1` or pass `--cloud`
|
|
223
|
+
- **Claude web**: Use `--cloud` explicitly
|
|
224
|
+
- **GitHub Actions**: Set `LUMENFLOW_CLOUD=1` in the job environment
|
|
225
|
+
- **Antigravity**: Use explicit `--cloud` activation
|
|
232
226
|
|
|
233
227
|
---
|
|
234
228
|
|
|
@@ -2,116 +2,65 @@
|
|
|
2
2
|
|
|
3
3
|
**Last updated:** {{DATE}}
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Use this checklist before running `pnpm wu:create`.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
## Step 1:
|
|
9
|
+
## Step 1: Confirm the Lane
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
|
-
|
|
12
|
+
pnpm lane:status
|
|
13
|
+
pnpm wu:infer-lane --paths "packages/@lumenflow/cli/src/init.ts" --desc "Fix init docs drift"
|
|
13
14
|
```
|
|
14
15
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
Examples:
|
|
18
|
-
|
|
19
|
-
- `"Framework: CLI"`
|
|
20
|
-
- `"Framework: Core"`
|
|
21
|
-
- `"Operations: CI/CD"`
|
|
22
|
-
- `"Content: Documentation"`
|
|
16
|
+
The lane should match the real implementation scope, not just the first file you noticed.
|
|
23
17
|
|
|
24
18
|
---
|
|
25
19
|
|
|
26
|
-
## Step 2: Required Fields
|
|
20
|
+
## Step 2: Gather the Required Fields
|
|
27
21
|
|
|
28
|
-
| Field
|
|
29
|
-
|
|
|
30
|
-
| `--
|
|
31
|
-
| `--
|
|
32
|
-
| `--
|
|
33
|
-
| `--
|
|
34
|
-
| `--
|
|
35
|
-
| `--
|
|
36
|
-
| `--
|
|
37
|
-
| `--test-paths-unit
|
|
38
|
-
| `--spec-refs`
|
|
39
|
-
|
|
40
|
-
---
|
|
22
|
+
| Field | Required For | Example |
|
|
23
|
+
| --------------------- | --------------------- | ------------------------------------------------------ |
|
|
24
|
+
| `--lane` | All WUs | `"Framework: CLI"` |
|
|
25
|
+
| `--title` | All WUs | `"Eliminate onboarding docs drift"` |
|
|
26
|
+
| `--description` | All WUs | `"Context: ... Problem: ... Solution: ..."` |
|
|
27
|
+
| `--acceptance` | All WUs | `--acceptance "Docs and templates stay aligned"` |
|
|
28
|
+
| `--exposure` | All WUs | `documentation` |
|
|
29
|
+
| `--code-paths` | Non-documentation WUs | `"packages/@lumenflow/cli/src/init.ts"` |
|
|
30
|
+
| `--test-paths-manual` | Non-documentation WUs | `"Run focused init/docs-sync tests"` |
|
|
31
|
+
| `--test-paths-unit` | Code WUs | `"packages/@lumenflow/cli/src/__tests__/init.test.ts"` |
|
|
32
|
+
| `--spec-refs` | Feature WUs | `"lumenflow://plans/WU-XXXX-plan.md"` |
|
|
41
33
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
Plans go in `$LUMENFLOW_HOME/plans/` (NOT in project):
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
mkdir -p $LUMENFLOW_HOME/plans
|
|
48
|
-
# or if LUMENFLOW_HOME is not set:
|
|
49
|
-
mkdir -p ~/.lumenflow/plans
|
|
50
|
-
|
|
51
|
-
# Create your plan
|
|
52
|
-
vim ~/.lumenflow/plans/WU-XXX-plan.md
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
Reference in wu:create:
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
--spec-refs "lumenflow://plans/WU-XXX-plan.md"
|
|
59
|
-
```
|
|
34
|
+
`--id` is optional. If omitted, `wu:create` allocates the next WU ID automatically.
|
|
60
35
|
|
|
61
36
|
---
|
|
62
37
|
|
|
63
|
-
## Step
|
|
38
|
+
## Step 3: Decide Plan Storage
|
|
39
|
+
|
|
40
|
+
If the work needs a plan, prefer repo-native or `lumenflow://plans/` references:
|
|
64
41
|
|
|
65
42
|
```bash
|
|
66
|
-
pnpm
|
|
43
|
+
pnpm plan:create --id INIT-XXX --title "Plan title"
|
|
44
|
+
pnpm wu:create --lane "Framework: CLI" --title "..." --plan
|
|
67
45
|
```
|
|
68
46
|
|
|
69
|
-
|
|
47
|
+
Avoid pointing `--spec-refs` at random local filesystem notes that other agents cannot resolve.
|
|
70
48
|
|
|
71
49
|
---
|
|
72
50
|
|
|
73
|
-
##
|
|
51
|
+
## Step 4: Validate Before Creating
|
|
74
52
|
|
|
75
53
|
```bash
|
|
76
|
-
pnpm wu:create \
|
|
77
|
-
--
|
|
78
|
-
--lane "Framework: CLI" \
|
|
79
|
-
--title "Add feature X" \
|
|
80
|
-
--description "Context: Users need X. Problem: X doesn't exist. Solution: Add X." \
|
|
81
|
-
--acceptance "Feature X works as specified" \
|
|
82
|
-
--acceptance "Unit tests pass with >90% coverage" \
|
|
83
|
-
--code-paths "packages/@lumenflow/cli/src/x.ts" \
|
|
84
|
-
--test-paths-unit "packages/@lumenflow/cli/__tests__/x.test.ts" \
|
|
85
|
-
--exposure backend-only \
|
|
86
|
-
--spec-refs "lumenflow://plans/WU-1234-plan.md"
|
|
54
|
+
pnpm wu:create --lane "Framework: CLI" --title "..." --description "..." \
|
|
55
|
+
--acceptance "..." --exposure documentation --validate
|
|
87
56
|
```
|
|
88
57
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
## Common Errors
|
|
92
|
-
|
|
93
|
-
### "Lane format invalid"
|
|
94
|
-
|
|
95
|
-
**Cause:** Missing colon or space in lane format.
|
|
96
|
-
|
|
97
|
-
**Fix:** Use `"Parent: Sublane"` format (colon + space).
|
|
98
|
-
|
|
99
|
-
### "Missing required field"
|
|
100
|
-
|
|
101
|
-
**Cause:** Required field not provided.
|
|
102
|
-
|
|
103
|
-
**Fix:** Add the missing `--field` argument.
|
|
104
|
-
|
|
105
|
-
### "WU already exists"
|
|
106
|
-
|
|
107
|
-
**Cause:** WU with this ID already exists.
|
|
108
|
-
|
|
109
|
-
**Fix:** Use a different ID or check existing WUs.
|
|
58
|
+
Let validation tell you which fields are still missing before you create the real spec.
|
|
110
59
|
|
|
111
60
|
---
|
|
112
61
|
|
|
113
62
|
## After Creation
|
|
114
63
|
|
|
115
|
-
1. Review
|
|
116
|
-
2. Claim
|
|
117
|
-
3.
|
|
64
|
+
1. Review `{{DOCS_TASKS_PATH}}/wu/WU-XXX.yaml`.
|
|
65
|
+
2. Claim it with `pnpm wu:claim --id WU-XXX --lane "<Lane>"`.
|
|
66
|
+
3. Move into the worktree immediately.
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Work Unit Sizing Guide
|
|
2
|
+
|
|
3
|
+
**Last updated:** {{DATE}}
|
|
4
|
+
|
|
5
|
+
Use this summary when deciding whether a WU still fits in a single agent session.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Baseline Heuristics
|
|
10
|
+
|
|
11
|
+
| Complexity | Files | Tool Calls | Suggested Strategy |
|
|
12
|
+
| ---------- | ----- | ---------- | --------------------------- |
|
|
13
|
+
| Simple | <20 | <50 | Single session |
|
|
14
|
+
| Medium | 20-50 | 50-100 | Checkpoint and resume |
|
|
15
|
+
| Complex | 50+ | 100+ | Decompose or orchestrate |
|
|
16
|
+
| Oversized | 100+ | 200+ | Split before implementation |
|
|
17
|
+
|
|
18
|
+
These are guardrails, not a license to keep pushing once context is clearly degrading.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Context Safety Triggers
|
|
23
|
+
|
|
24
|
+
Checkpoint and hand off when any of these happen:
|
|
25
|
+
|
|
26
|
+
- Context usage approaches 50% and is still climbing
|
|
27
|
+
- Tool calls exceed roughly 50 in one session
|
|
28
|
+
- File churn keeps widening without clear closure
|
|
29
|
+
- You have to repeatedly rediscover the same repo rules
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Recovery Pattern
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
pnpm mem:checkpoint "state before handoff" --wu WU-XXX
|
|
37
|
+
pnpm wu:brief --id WU-XXX --client codex-cli
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
If the WU is clearly too large, split it instead of relying on a heroic handoff.
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Docs-Only Exception
|
|
45
|
+
|
|
46
|
+
Documentation WUs can tolerate broader file counts when the change pattern is shallow and mechanical, but they still need to stay understandable in one session.
|
|
47
|
+
|
|
48
|
+
If the docs work starts spilling into CLI, core, or packaging changes, treat it like a normal cross-code WU again.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: bug-classification
|
|
3
3
|
description: Classify bugs (P0-P3) and determine fix-in-place vs separate Bug WU. Use when bug discovered mid-WU, deciding bug priority, or handling production issues.
|
|
4
4
|
version: 1.0.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: §8 (Bug Handling Mid-WU)
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Grep
|
|
@@ -189,4 +189,4 @@ blocking: []
|
|
|
189
189
|
|
|
190
190
|
## Reference
|
|
191
191
|
|
|
192
|
-
See [LumenFlow Agent Capsule](../../../
|
|
192
|
+
See [LumenFlow Agent Capsule](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md) for complete bug handling guide.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: code-quality
|
|
3
3
|
description: Shared patterns for SOLID/DRY code review, hexagonal architecture compliance, TypeScript best practices, and performance anti-patterns. Use when reviewing code quality, checking architecture boundaries, or validating TypeScript patterns.
|
|
4
4
|
version: 1.1.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: Core Principles, Hexagonal Architecture
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Grep, Glob
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, Grep, Glob
|
|
|
10
10
|
|
|
11
11
|
# Code Quality Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
|
|
14
14
|
|
|
15
15
|
## When to Use
|
|
16
16
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: context-management
|
|
3
3
|
description: Session checkpoint patterns, output bypass for large results, when to spawn fresh sub-agents. Use for long-running sessions, context exhaustion, or agent coordination.
|
|
4
4
|
version: 1.4.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_ONBOARDING_PATH}}/agent-invocation-guide.md
|
|
6
6
|
source_sections: Context Tiers, Session Management, Wave Orchestration
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Write, Bash
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, Write, Bash
|
|
|
10
10
|
|
|
11
11
|
# Context Management Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_ONBOARDING_PATH}}/agent-invocation-guide.md`
|
|
14
14
|
|
|
15
15
|
Patterns for managing context in long-running AI coding sessions.
|
|
16
16
|
|
|
@@ -56,7 +56,7 @@ pnpm wu:brief --id WU-XXX --client claude-code
|
|
|
56
56
|
- Recovery mechanisms are complex and vendor-specific
|
|
57
57
|
- Prevention (fresh agent) is simpler and more reliable than recovery
|
|
58
58
|
|
|
59
|
-
**This is not failure—it's disciplined execution.** See [wu-sizing-guide.md](../../../
|
|
59
|
+
**This is not failure—it's disciplined execution.** See [wu-sizing-guide.md](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/wu-sizing-guide.md) for complete sizing thresholds.
|
|
60
60
|
|
|
61
61
|
---
|
|
62
62
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: execution-memory
|
|
3
3
|
description: Memory layer for session tracking, context recovery, and agent coordination. Use when resuming work after /clear, coordinating with parallel agents, or managing long-running sessions.
|
|
4
4
|
version: 1.2.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{QUICK_REF_LINK}}
|
|
6
6
|
source_sections: Memory Commands
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
@@ -94,7 +94,7 @@ Edits initiative YAML fields atomically using micro-worktree isolation:
|
|
|
94
94
|
|
|
95
95
|
## Initiative Structure
|
|
96
96
|
|
|
97
|
-
Initiatives are defined in `
|
|
97
|
+
Initiatives are defined in `{{DOCS_TASKS_PATH}}/initiatives/INIT-001.yaml`:
|
|
98
98
|
|
|
99
99
|
```yaml
|
|
100
100
|
id: INIT-001
|
|
@@ -157,7 +157,7 @@ pnpm wu:brief --id WU-1504 --evidence-only # Evidence only, no prompt ou
|
|
|
157
157
|
- Validation agents checking orchestrator's work
|
|
158
158
|
- Explore agents for codebase research
|
|
159
159
|
|
|
160
|
-
See [agent-invocation-guide.md](../../../
|
|
160
|
+
See [agent-invocation-guide.md](../../../{{DOCS_ONBOARDING_PATH}}/agent-invocation-guide.md) for decision tree.
|
|
161
161
|
|
|
162
162
|
## Best Practices
|
|
163
163
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: library-first
|
|
3
3
|
description: Validate well-known libraries solve your problem before custom code. Use when implementing parsing, dates, validation, or any non-trivial logic.
|
|
4
4
|
version: 1.0.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_ONBOARDING_PATH}}/library-first-toolkit.md
|
|
6
6
|
source_sections: Validation Protocol, Decision Tree, Context7 Query Templates
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, mcp__context7__*
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, mcp__context7__*
|
|
|
10
10
|
|
|
11
11
|
# Library-First Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_ONBOARDING_PATH}}/library-first-toolkit.md` (canonical)
|
|
14
14
|
|
|
15
15
|
Search for libraries BEFORE writing custom code. Custom implementations create debt, violate DRY/SOLID, and introduce bugs that libraries have already solved.
|
|
16
16
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: lumenflow-gates
|
|
3
3
|
description: Quality gates troubleshooting (format, lint, typecheck, tests). Use when gates fail, debugging format/lint/typecheck errors, or determining if failure is from your changes vs pre-existing.
|
|
4
4
|
version: 2.1.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: Validation & Gates
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, Bash, Grep
|
|
|
10
10
|
|
|
11
11
|
# LumenFlow Gates Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
|
|
14
14
|
|
|
15
15
|
## When to Use
|
|
16
16
|
|
|
@@ -84,4 +84,4 @@ pnpm tasks:validate # WU YAML validation
|
|
|
84
84
|
|
|
85
85
|
---
|
|
86
86
|
|
|
87
|
-
**Full spec**: [LumenFlow Agent Capsule](../../../
|
|
87
|
+
**Full spec**: [LumenFlow Agent Capsule](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: multi-agent-coordination
|
|
3
3
|
description: Coordinate multiple agents on parallel WUs using git branch locking. Use when spawning sub-agents, coordinating parallel WUs, or handling abandoned WU recovery.
|
|
4
4
|
version: 2.1.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_ONBOARDING_PATH}}/agent-invocation-guide.md
|
|
6
6
|
last_updated: {{DATE}}
|
|
7
7
|
allowed-tools: Read, Bash, Grep
|
|
8
8
|
---
|
|
@@ -87,4 +87,4 @@ pnpm mem:checkpoint "Ready for handoff" --wu WU-XXX # Handoff
|
|
|
87
87
|
|
|
88
88
|
---
|
|
89
89
|
|
|
90
|
-
**Full docs**: [agent-invocation-guide.md](../../../
|
|
90
|
+
**Full docs**: [agent-invocation-guide.md](../../../{{DOCS_ONBOARDING_PATH}}/agent-invocation-guide.md) | [execution-memory skill](../execution-memory/SKILL.md)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: tdd-workflow
|
|
3
3
|
description: Test-driven development workflow. RED-GREEN-REFACTOR applies to all code; 5-step ports-first for hex architecture. Use when implementing new features, writing tests, or working with hexagonal architecture.
|
|
4
4
|
version: 2.1.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: AI-TDD 5-Step Workflow, Hexagonal Architecture
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Write, Edit, Bash, Grep
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, Write, Edit, Bash, Grep
|
|
|
10
10
|
|
|
11
11
|
# TDD Workflow Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
|
|
14
14
|
|
|
15
15
|
## When to Use
|
|
16
16
|
|
|
@@ -138,4 +138,4 @@ pnpm test:coverage # Check coverage
|
|
|
138
138
|
|
|
139
139
|
---
|
|
140
140
|
|
|
141
|
-
**Full spec**: [LumenFlow Agent Capsule](../../../
|
|
141
|
+
**Full spec**: [LumenFlow Agent Capsule](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: worktree-discipline
|
|
3
3
|
description: Prevents the "absolute path trap" in Write/Edit/Read tools. Use when working in worktrees, before file operations, or when changes don't appear in git status.
|
|
4
4
|
version: 2.0.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: Worktree Discipline, Tool Usage
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
@@ -25,7 +25,7 @@ allowed-tools: Read, Bash, Grep
|
|
|
25
25
|
|
|
26
26
|
// WRONG - Absolute path bypasses worktree
|
|
27
27
|
Write({
|
|
28
|
-
file_path: '
|
|
28
|
+
file_path: '<absolute-path>/apps/web/src/validator.ts',
|
|
29
29
|
content: '...',
|
|
30
30
|
});
|
|
31
31
|
// Result: Written to MAIN checkout, not worktree!
|
|
@@ -51,13 +51,13 @@ Write({
|
|
|
51
51
|
|
|
52
52
|
2. **Check file path format**:
|
|
53
53
|
|
|
54
|
-
| Pattern
|
|
55
|
-
|
|
|
56
|
-
| Starts with
|
|
57
|
-
| Contains full repo path
|
|
58
|
-
| Starts with package name
|
|
59
|
-
| Starts with `./` or `../`
|
|
60
|
-
| Just filename
|
|
54
|
+
| Pattern | Safe? | Example |
|
|
55
|
+
| ----------------------------------- | ----- | ------------------------------ |
|
|
56
|
+
| Starts with an absolute-root prefix | NO | `<absolute-path>/.../file.ts` |
|
|
57
|
+
| Contains full repo path | NO | `<repo-root>/apps/.../file.ts` |
|
|
58
|
+
| Starts with package name | YES | `apps/web/src/...` |
|
|
59
|
+
| Starts with `./` or `../` | YES | `./src/lib/...` |
|
|
60
|
+
| Just filename | YES | `README.md` |
|
|
61
61
|
|
|
62
62
|
3. **Use relative paths for ALL file operations**
|
|
63
63
|
|
|
@@ -69,7 +69,7 @@ Write({
|
|
|
69
69
|
|
|
70
70
|
**Red flags** (you're about to fall into the trap):
|
|
71
71
|
|
|
72
|
-
- Path starts with
|
|
72
|
+
- Path starts with an absolute-root prefix
|
|
73
73
|
- Path contains organisation/project name
|
|
74
74
|
- Path length > 50 characters (suspiciously long)
|
|
75
75
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: wu-lifecycle
|
|
3
3
|
description: Work Unit claim/block/done workflow automation. Use when claiming WUs, blocking/unblocking, running wu:prep + wu:done, or understanding WU state transitions.
|
|
4
4
|
version: 2.2.0
|
|
5
|
-
source:
|
|
5
|
+
source: {{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
6
|
source_sections: WU Lifecycle
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
@@ -10,7 +10,7 @@ allowed-tools: Read, Bash, Grep
|
|
|
10
10
|
|
|
11
11
|
# WU Lifecycle Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `
|
|
13
|
+
**Source**: `{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
|
|
14
14
|
|
|
15
15
|
## When to Use
|
|
16
16
|
|
|
@@ -116,4 +116,4 @@ pnpm wu:done --id WU-XXX --skip-gates --reason "Pre-existing" --fix-wu WU-YYY
|
|
|
116
116
|
|
|
117
117
|
---
|
|
118
118
|
|
|
119
|
-
**Full spec**: [LumenFlow Agent Capsule](../../../
|
|
119
|
+
**Full spec**: [LumenFlow Agent Capsule](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md)
|