@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.
Files changed (51) hide show
  1. package/README.md +78 -74
  2. package/dist/docs-sync.js +24 -29
  3. package/dist/docs-sync.js.map +1 -1
  4. package/dist/init-scaffolding.js +2 -9
  5. package/dist/init-scaffolding.js.map +1 -1
  6. package/dist/init.js +7 -18
  7. package/dist/init.js.map +1 -1
  8. package/dist/onboarding-template-paths.js +19 -0
  9. package/dist/onboarding-template-paths.js.map +1 -0
  10. package/dist/public-manifest.js +2 -2
  11. package/dist/public-manifest.js.map +1 -1
  12. package/dist/sync-templates.js +12 -1
  13. package/dist/sync-templates.js.map +1 -1
  14. package/dist/template-directory-resolver.js +71 -0
  15. package/dist/template-directory-resolver.js.map +1 -0
  16. package/dist/wu-done-check.js +33 -13
  17. package/dist/wu-done-check.js.map +1 -1
  18. package/dist/wu-done.js +6 -5
  19. package/dist/wu-done.js.map +1 -1
  20. package/dist/wu-spawn-prompt-builders.js +96 -23
  21. package/dist/wu-spawn-prompt-builders.js.map +1 -1
  22. package/package.json +8 -8
  23. package/packs/sidekick/.turbo/turbo-build.log +1 -1
  24. package/packs/sidekick/package.json +1 -1
  25. package/packs/software-delivery/.turbo/turbo-build.log +1 -1
  26. package/packs/software-delivery/package.json +1 -1
  27. package/templates/core/.lumenflow/constraints.md.template +3 -3
  28. package/templates/core/LUMENFLOW.md.template +17 -17
  29. package/templates/core/UPGRADING.md.template +30 -11
  30. package/templates/core/ai/onboarding/agent-safety-card.md.template +15 -16
  31. package/templates/core/ai/onboarding/first-15-mins.md.template +80 -0
  32. package/templates/core/ai/onboarding/first-wu-mistakes.md.template +3 -3
  33. package/templates/core/ai/onboarding/initiative-orchestration.md.template +1 -1
  34. package/templates/core/ai/onboarding/lane-inference.md.template +64 -0
  35. package/templates/core/ai/onboarding/local-only.md.template +56 -0
  36. package/templates/core/ai/onboarding/quick-ref-commands.md.template +122 -92
  37. package/templates/core/ai/onboarding/starting-prompt.md.template +91 -46
  38. package/templates/core/ai/onboarding/vendor-support.md.template +14 -20
  39. package/templates/core/ai/onboarding/wu-create-checklist.md.template +31 -82
  40. package/templates/core/ai/onboarding/wu-sizing-guide.md.template +48 -0
  41. package/templates/vendors/claude/.claude/skills/bug-classification/SKILL.md.template +2 -2
  42. package/templates/vendors/claude/.claude/skills/code-quality/SKILL.md.template +2 -2
  43. package/templates/vendors/claude/.claude/skills/context-management/SKILL.md.template +3 -3
  44. package/templates/vendors/claude/.claude/skills/execution-memory/SKILL.md.template +1 -1
  45. package/templates/vendors/claude/.claude/skills/initiative-management/SKILL.md.template +2 -2
  46. package/templates/vendors/claude/.claude/skills/library-first/SKILL.md.template +2 -2
  47. package/templates/vendors/claude/.claude/skills/lumenflow-gates/SKILL.md.template +3 -3
  48. package/templates/vendors/claude/.claude/skills/multi-agent-coordination/SKILL.md.template +2 -2
  49. package/templates/vendors/claude/.claude/skills/tdd-workflow/SKILL.md.template +3 -3
  50. package/templates/vendors/claude/.claude/skills/worktree-discipline/SKILL.md.template +10 -10
  51. 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
- Explicit activation (`--cloud` or `LUMENFLOW_CLOUD=1`) always takes precedence over
191
- auto-detection.
190
+ Cloud activation is explicit-only. `--cloud` and `LUMENFLOW_CLOUD=1` are the only
191
+ runtime activation paths.
192
192
 
193
- ### Config-Driven Auto-Detection (Opt-In)
193
+ ### Cloud Config Compatibility Fields
194
194
 
195
- For environments where agents should automatically enter cloud mode, enable
196
- auto-detection in `workspace.yaml`:
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: true # default: false
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
- - `auto_detect` defaults to `false` (opt-in, not opt-out)
211
- - No vendor-specific signals are hardcoded; all signals are user-configured
212
- - Each signal supports either presence checks (`name` only) or exact-value
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` in the environment or configure auto-detection with `name: CODEX`
229
- - **Claude web**: Use `--cloud` flag explicitly or configure `name: CLAUDE_CODE` in env_signals
230
- - **GitHub Actions**: Configure `name: GITHUB_ACTIONS, equals: 'true'` in env_signals
231
- - **Antigravity**: Expected to work with explicit `--cloud` flag; auto-detection signals TBD
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
- Before running `pnpm wu:create`, verify these items.
5
+ Use this checklist before running `pnpm wu:create`.
6
6
 
7
7
  ---
8
8
 
9
- ## Step 1: Check Valid Lanes
9
+ ## Step 1: Confirm the Lane
10
10
 
11
11
  ```bash
12
- grep -A 30 "lanes:" workspace.yaml
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
- **Format:** `"Parent: Sublane"` (colon + single space)
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 | Required For | Example |
29
- | ------------------ | ------------ | ------------------------------------------------ |
30
- | `--id` | All | `WU-1234` |
31
- | `--lane` | All | `"Experience: Chat"` |
32
- | `--title` | All | `"Add feature"` |
33
- | `--description` | All | `"Context: ... Problem: ... Solution: ..."` |
34
- | `--acceptance` | All | `--acceptance "Works"` (repeatable) |
35
- | `--exposure` | All | `ui`, `api`, `backend-only`, `documentation` |
36
- | `--code-paths` | Code WUs | `"src/a.ts,src/b.ts"` |
37
- | `--test-paths-unit`| Code WUs | `"src/__tests__/a.test.ts"` |
38
- | `--spec-refs` | Feature WUs | `"lumenflow://plans/WU-XXX-plan.md"` |
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
- ## Step 3: Plan Storage
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 4: Validate First
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 wu:create --id WU-XXX ... --validate
43
+ pnpm plan:create --id INIT-XXX --title "Plan title"
44
+ pnpm wu:create --lane "Framework: CLI" --title "..." --plan
67
45
  ```
68
46
 
69
- Fix errors, then remove `--validate` to create.
47
+ Avoid pointing `--spec-refs` at random local filesystem notes that other agents cannot resolve.
70
48
 
71
49
  ---
72
50
 
73
- ## Complete Example
51
+ ## Step 4: Validate Before Creating
74
52
 
75
53
  ```bash
76
- pnpm wu:create \
77
- --id WU-1234 \
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 the created YAML: `cat docs/04-operations/tasks/wu/WU-XXX.yaml`
116
- 2. Claim the WU: `pnpm wu:claim --id WU-XXX --lane "Lane"`
117
- 3. cd to worktree: `cd worktrees/<lane>-wu-xxx`
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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md) for complete bug handling guide.
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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
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: docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md
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**: `docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md`
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](../../../docs/04-operations/_frameworks/lumenflow/wu-sizing-guide.md) for complete sizing thresholds.
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: docs/04-operations/_frameworks/lumenflow/agent/onboarding/quick-ref-commands.md
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 `docs/04-operations/tasks/initiatives/INIT-001.yaml`:
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](../../../docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md) for decision tree.
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: docs/04-operations/_frameworks/lumenflow/agent/onboarding/library-first-toolkit.md
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**: `docs/04-operations/_frameworks/lumenflow/agent/onboarding/library-first-toolkit.md` (canonical)
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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
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](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md)
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: docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md
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](../../../docs/04-operations/_frameworks/lumenflow/agent/onboarding/agent-invocation-guide.md) | [execution-memory skill](../execution-memory/SKILL.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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
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](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md)
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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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: '/home/user/source/project/apps/web/src/validator.ts',
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 | Safe? | Example |
55
- | --------------------------------- | ----- | ------------------------ |
56
- | Starts with `/home/` or `/Users/` | NO | `/home/user/.../file.ts` |
57
- | Contains full repo path | NO | `/source/project/...` |
58
- | Starts with package name | YES | `apps/web/src/...` |
59
- | Starts with `./` or `../` | YES | `./src/lib/...` |
60
- | Just filename | YES | `README.md` |
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 `/home/` or `/Users/`
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: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
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**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
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](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md)
119
+ **Full spec**: [LumenFlow Agent Capsule](../../../{{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/lumenflow-agent-capsule.md)