maestro-flow 0.1.3 → 0.2.0

package/.codex/skills/manage-memory/SKILL.md

@@ -1,72 +1,72 @@
----
-name: maestro-memory
-description: Manage memory entries across workflow and system stores (list, search, view, edit, delete, prune)
-argument-hint: "[list|search|view|edit|delete|prune] [query|id|file] [--store workflow|system|all] [--tag tag] [--type compact|tip]"
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
----
-
-# Memory Management
-
-## Usage
-
-```bash
-$maestro-memory
-$maestro-memory "list --store workflow"
-$maestro-memory "search authentication"
-$maestro-memory "view MEM-20260318-001"
-$maestro-memory "edit MEMORY.md"
-$maestro-memory "delete TIP-20260318-001 --confirm"
-$maestro-memory "prune --before 2026-01-01 --type tip --dry-run"
-```
-
----
-
-## Implementation
-
-### Step 1: Resolve Store Paths
-
-- **Workflow store**: `.workflow/memory/` (entries: `MEM-*.md`, `TIP-*.md`, index: `memory-index.json`)
-- **System store**: `~/.claude/projects/{project}/memory/` (files: `MEMORY.md` + topic `.md` files)
-
-Derive system path from project root (replace path separators with `--`, prefix drive letter).
-
-### Step 2: Parse Subcommand
-
-Default to `list` if no arguments. Parse first token as subcommand.
-
-### Step 3: Execute Subcommand
-
-**list**: Show entries from both stores (or filtered by `--store`, `--tag`, `--type`).
-- Workflow: read `memory-index.json`, display ID, type, date, tags, title
-- System: list `.md` files in system memory directory
-
-**search `<query>`**: Full-text grep across both stores. Rank by match count.
-
-**view `<id|file>`**: Auto-detect store from format (`MEM-*/TIP-*` = workflow, else system). Display full content.
-
-**edit `<file>`**: Edit a system memory file. Read current content, apply changes. Warn if MEMORY.md exceeds 200 lines (W003).
-
-**delete `<id|file>`**: Require confirmation (or `--confirm` flag). MEMORY.md cannot be deleted (E004). Remove entry file and update `memory-index.json`.
-
-**prune**: Requires at least one filter (`--tag`, `--type`, `--before`, `--after`). Workflow store only. `--dry-run` previews without deleting.
-
-### Step 4: Integrity Check
-
-After write operations, verify:
-- No orphaned files without index entries (W001)
-- No dangling index references to missing files (W001)
-- System MEMORY.md references valid topic files (W002)
-
----
-
-## Error Handling
-
-| Code | Severity | Description |
-|------|----------|-------------|
-| E001 | error | No memory stores found -- run `Skill({ skill: "memory-capture" })` or create MEMORY.md |
-| E002 | error | Entry ID or filename not found |
-| E003 | error | Prune requires at least one filter flag |
-| E004 | error | Cannot delete MEMORY.md -- use `edit` subcommand instead |
-| W001 | warning | Index has orphaned files or dangling references |
-| W002 | warning | MEMORY.md references non-existent topic file |
-| W003 | warning | MEMORY.md exceeds 200 lines -- content truncated at load |
+---
+name: maestro-memory
+description: Manage memory entries across workflow and system stores (list, search, view, edit, delete, prune)
+argument-hint: "[list|search|view|edit|delete|prune] [query|id|file] [--store workflow|system|all] [--tag tag] [--type compact|tip]"
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+---
+
+# Memory Management
+
+## Usage
+
+```bash
+$maestro-memory
+$maestro-memory "list --store workflow"
+$maestro-memory "search authentication"
+$maestro-memory "view MEM-20260318-001"
+$maestro-memory "edit MEMORY.md"
+$maestro-memory "delete TIP-20260318-001 --confirm"
+$maestro-memory "prune --before 2026-01-01 --type tip --dry-run"
+```
+
+---
+
+## Implementation
+
+### Step 1: Resolve Store Paths
+
+- **Workflow store**: `.workflow/memory/` (entries: `MEM-*.md`, `TIP-*.md`, index: `memory-index.json`)
+- **System store**: `~/.claude/projects/{project}/memory/` (files: `MEMORY.md` + topic `.md` files)
+
+Derive system path from project root (replace path separators with `--`, prefix drive letter).
+
+### Step 2: Parse Subcommand
+
+Default to `list` if no arguments. Parse first token as subcommand.
+
+### Step 3: Execute Subcommand
+
+**list**: Show entries from both stores (or filtered by `--store`, `--tag`, `--type`).
+- Workflow: read `memory-index.json`, display ID, type, date, tags, title
+- System: list `.md` files in system memory directory
+
+**search `<query>`**: Full-text grep across both stores. Rank by match count.
+
+**view `<id|file>`**: Auto-detect store from format (`MEM-*/TIP-*` = workflow, else system). Display full content.
+
+**edit `<file>`**: Edit a system memory file. Read current content, apply changes. Warn if MEMORY.md exceeds 200 lines (W003).
+
+**delete `<id|file>`**: Require confirmation (or `--confirm` flag). MEMORY.md cannot be deleted (E004). Remove entry file and update `memory-index.json`.
+
+**prune**: Requires at least one filter (`--tag`, `--type`, `--before`, `--after`). Workflow store only. `--dry-run` previews without deleting.
+
+### Step 4: Integrity Check
+
+After write operations, verify:
+- No orphaned files without index entries (W001)
+- No dangling index references to missing files (W001)
+- System MEMORY.md references valid topic files (W002)
+
+---
+
+## Error Handling
+
+| Code | Severity | Description |
+|------|----------|-------------|
+| E001 | error | No memory stores found -- run `Skill({ skill: "memory-capture" })` or create MEMORY.md |
+| E002 | error | Entry ID or filename not found |
+| E003 | error | Prune requires at least one filter flag |
+| E004 | error | Cannot delete MEMORY.md -- use `edit` subcommand instead |
+| W001 | warning | Index has orphaned files or dangling references |
+| W002 | warning | MEMORY.md references non-existent topic file |
+| W003 | warning | MEMORY.md exceeds 200 lines -- content truncated at load |

package/.codex/skills/manage-memory-capture/SKILL.md

@@ -1,86 +1,86 @@
----
-name: maestro-memory-capture
-description: Capture session memory (compact or tip) into .workflow/memory/ with JSON index
-argument-hint: "[compact|tip] [description] [--tag tag1,tag2]"
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
----
-
-# Memory Capture
-
-## Usage
-
-```bash
-$maestro-memory-capture
-$maestro-memory-capture "compact"
-$maestro-memory-capture "tip Always check state.json before phase operations --tag workflow,state"
-$maestro-memory-capture "compact Full auth implementation session"
-```
-
-**Modes**: `compact` (full session compression) or `tip` (quick note with tags).
-No arguments: auto-detect or ask user.
-
----
-
-## Implementation
-
-### Step 1: Validate
-
-```bash
-test -d .workflow || exit 1  # E001: not initialized
-```
-
-Create `.workflow/memory/` if it does not exist.
-
-### Step 2: Detect Mode
-
-Parse first token as mode (`compact` or `tip`).
-If absent or ambiguous, ask user via AskUserQuestion.
-
-### Step 3: Capture Content
-
-**Compact mode**:
-1. Analyze current conversation for: objective, key decisions, modified files, current plan state, pending work
-2. Generate entry ID: `MEM-{YYYYMMDD}-{NNN}`
-3. Write `.workflow/memory/MEM-{id}.md` with sections:
-   - Objective, Key Decisions, Files Modified (absolute paths), Execution Plan (verbatim), Pending Work, Context Notes
-
-**Tip mode**:
-1. Extract content (everything after `tip`) and parse `--tag` flag
-2. Generate entry ID: `TIP-{YYYYMMDD}-{NNN}`
-3. Write `.workflow/memory/TIP-{id}.md` with: content, tags, timestamp, context
-
-### Step 4: Update Index
-
-Read or create `.workflow/memory/memory-index.json`.
-Append new entry metadata:
-
-```json
-{
-  "id": "{entry_id}",
-  "type": "compact|tip",
-  "date": "{ISO}",
-  "title": "{short title}",
-  "tags": ["tag1", "tag2"],
-  "file": "{filename}"
-}
-```
-
-### Step 5: Confirm
-
-```
-=== MEMORY CAPTURED ===
-ID: {entry_id}
-Type: {compact|tip}
-File: .workflow/memory/{filename}
-```
-
----
-
-## Error Handling
-
-| Code | Severity | Description |
-|------|----------|-------------|
-| E001 | error | `.workflow/` not initialized -- run `Skill({ skill: "maestro-init" })` first |
-| E002 | error | Empty note content in tip mode |
-| W001 | warning | No active workflow session -- compact captures conversation only |
-| W002 | warning | No explicit plan found -- using inferred plan |
+---
+name: maestro-memory-capture
+description: Capture session memory (compact or tip) into .workflow/memory/ with JSON index
+argument-hint: "[compact|tip] [description] [--tag tag1,tag2]"
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+---
+
+# Memory Capture
+
+## Usage
+
+```bash
+$maestro-memory-capture
+$maestro-memory-capture "compact"
+$maestro-memory-capture "tip Always check state.json before phase operations --tag workflow,state"
+$maestro-memory-capture "compact Full auth implementation session"
+```
+
+**Modes**: `compact` (full session compression) or `tip` (quick note with tags).
+No arguments: auto-detect or ask user.
+
+---
+
+## Implementation
+
+### Step 1: Validate
+
+```bash
+test -d .workflow || exit 1  # E001: not initialized
+```
+
+Create `.workflow/memory/` if it does not exist.
+
+### Step 2: Detect Mode
+
+Parse first token as mode (`compact` or `tip`).
+If absent or ambiguous, ask user via AskUserQuestion.
+
+### Step 3: Capture Content
+
+**Compact mode**:
+1. Analyze current conversation for: objective, key decisions, modified files, current plan state, pending work
+2. Generate entry ID: `MEM-{YYYYMMDD}-{NNN}`
+3. Write `.workflow/memory/MEM-{id}.md` with sections:
+   - Objective, Key Decisions, Files Modified (absolute paths), Execution Plan (verbatim), Pending Work, Context Notes
+
+**Tip mode**:
+1. Extract content (everything after `tip`) and parse `--tag` flag
+2. Generate entry ID: `TIP-{YYYYMMDD}-{NNN}`
+3. Write `.workflow/memory/TIP-{id}.md` with: content, tags, timestamp, context
+
+### Step 4: Update Index
+
+Read or create `.workflow/memory/memory-index.json`.
+Append new entry metadata:
+
+```json
+{
+  "id": "{entry_id}",
+  "type": "compact|tip",
+  "date": "{ISO}",
+  "title": "{short title}",
+  "tags": ["tag1", "tag2"],
+  "file": "{filename}"
+}
+```
+
+### Step 5: Confirm
+
+```
+=== MEMORY CAPTURED ===
+ID: {entry_id}
+Type: {compact|tip}
+File: .workflow/memory/{filename}
+```
+
+---
+
+## Error Handling
+
+| Code | Severity | Description |
+|------|----------|-------------|
+| E001 | error | `.workflow/` not initialized -- run `Skill({ skill: "maestro-init" })` first |
+| E002 | error | Empty note content in tip mode |
+| W001 | warning | No active workflow session -- compact captures conversation only |
+| W002 | warning | No explicit plan found -- using inferred plan |