Skip to content
This repository was archived by the owner on Apr 11, 2026. It is now read-only.

Commit c26d087

Browse files
committed
feat(skills): add memory auto-inject with levels and tag reference to preamble
- Enhanced preamble Step 3 with memory levels (L1/L2/L3), epic search, and critical-severity pause - Added Skill Tag Reference table mapping 9 skills to recommended tags - Added SKILL_TAGS comments to 4 skills: flow-code-run, flow-code, flow-code-auto-improve, flow-code-debug Task: fn-23-gstack-inspired-plugin-optimizations.3
1 parent 3d0b914 commit c26d087

5 files changed

Lines changed: 33 additions & 1 deletion

File tree

skills/_shared/preamble.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,40 @@ $FLOWCTL status --interrupted --json
2020
If interrupted tasks exist, notify the user before proceeding.
2121

2222
## Step 3: Load relevant memory
23+
24+
Run memory injection to surface relevant learnings, pitfalls, and conventions:
25+
2326
```bash
27+
# Inject entries matching skill domain (replace SKILL_TAGS with skill-specific tags)
2428
$FLOWCTL memory inject --tags "{{SKILL_TAGS}}" --json 2>/dev/null || true
29+
30+
# If working on a specific epic, also search for related memories
31+
$FLOWCTL memory search "{{EPIC_CONTEXT}}" --type pitfall 2>/dev/null || true
2532
```
26-
Load memory entries relevant to the current skill context. Replace `{{SKILL_TAGS}}` with skill-specific tags.
33+
34+
Memory levels:
35+
- **L1 (headlines)**: Default — shows entry titles for quick scan
36+
- **L2 (summaries)**: Use `--full` for entries matching current context
37+
- **L3 (full content)**: Only when debugging a specific known pitfall
38+
39+
If memory returns critical-severity pitfalls, **pause and review them** before proceeding.
2740

2841
## Step 4: Session context
2942
- Current branch: `git branch --show-current`
3043
- Active epic: check `.flow/` for in-progress epics
3144
- Plugin version: read from plugin.json
45+
46+
## Skill Tag Reference
47+
48+
| Skill | Recommended Tags |
49+
|-------|-----------------|
50+
| flow-code-run | workflow,pipeline,planning |
51+
| flow-code-debug | debugging,testing,errors |
52+
| flow-code-auto-improve | performance,quality,security |
53+
| flow-code-api-design | api,architecture,contracts |
54+
| flow-code-cicd | ci,deployment,automation |
55+
| flow-code-django | django,python,backend |
56+
| flow-code-performance | performance,optimization,benchmarks |
57+
| flow-code-qa | testing,qa,browser,visual |
58+
| flow-code-design-review | design,css,visual,ui |
59+
| (default) | (use skill name as tag) |

skills/flow-code-auto-improve/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ context: fork
99
# Auto-Improve
1010

1111
> **Startup:** Follow [Startup Sequence](../_shared/preamble.md) before proceeding.
12+
<!-- SKILL_TAGS: performance,quality,security -->
1213
1314
One command to start autonomous code improvement. Auto-detects everything, starts immediately.
1415

skills/flow-code-debug/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ tier: 2
77
# Systematic Debugging
88

99
> **Startup:** Follow [Startup Sequence](../_shared/preamble.md) before proceeding.
10+
<!-- SKILL_TAGS: debugging,testing,errors -->
1011
1112
## The Iron Law
1213

skills/flow-code-run/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ user-invocable: true
88
# Flow Code Run
99

1010
> **Startup:** Follow [Startup Sequence](../_shared/preamble.md) before proceeding.
11+
<!-- SKILL_TAGS: workflow,pipeline,planning -->
1112
1213
Unified pipeline entry point. Drives the entire development lifecycle through flowctl phase next/done.
1314

skills/flow-code/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ tier: 4
77
# Flow-Code Task Management
88

99
> **Startup:** Follow [Startup Sequence](../_shared/preamble.md) before proceeding.
10+
<!-- SKILL_TAGS: tasks,epics,workflow -->
1011
1112
Quick task operations in `.flow/`. For planning features use `/flow-code:plan`, for executing use `/flow-code:work`.
1213

0 commit comments

Comments
 (0)