@howlil/ez-agents 3.4.2 → 4.0.0

package/commands/ez/add-todo.md

@@ -1,47 +0,0 @@
----
-name: ez:add-todo
-description: Capture idea or task as todo from current conversation context
-argument-hint: [optional description]
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
----
-
-<objective>
-Capture an idea, task, or issue that surfaces during an EZ Agents session as a structured todo for later work.
-
-Routes to the add-todo workflow which handles:
-- Directory structure creation
-- Content extraction from arguments or conversation
-- Area inference from file paths
-- Duplicate detection and resolution
-- Todo file creation with frontmatter
-- STATE.md updates
-- Git commits
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/add-todo.md
-</execution_context>
-
-<context>
-Arguments: $ARGUMENTS (optional todo description)
-
-State is resolved in-workflow via `init todos` and targeted reads.
-</context>
-
-<process>
-**Follow the add-todo workflow** from `@~/.claude/ez-agents/workflows/add-todo.md`.
-
-The workflow handles all logic including:
-1. Directory ensuring
-2. Existing area checking
-3. Content extraction (arguments or conversation)
-4. Area inference
-5. Duplicate checking
-6. File creation with slug generation
-7. STATE.md updates
-8. Git commits
-</process>

package/commands/ez/auth.md

@@ -1,87 +0,0 @@
----
-name: ez:auth
-description: Manage API credentials securely (save, list, delete)
-argument-hint: "<save|list|delete|test> [provider] [secret]"
-agent: ez-helper
-allowed-tools:
-  - Read
-  - Bash
----
-<objective>
-Manage API credentials securely using system keychain or fallback file storage
-
-**Subcommands:**
-- `ez:auth save <provider> <secret>` — Save credential for provider
-- `ez:auth list` — List all stored providers
-- `ez:auth delete <provider>` — Delete credential for provider
-- `ez:auth test` — Test credential system and show keychain status
-
-**Providers:** anthropic, moonshot, alibaba, qwen, openai
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/ez-helper.md
-</execution_context>
-
-<context>
-@.planning/PROJECT.md
-@.planning/STATE.md
-
-# Credential storage module:
-@ez-agents/bin/lib/auth.cjs
-
-# EZ tools CLI:
-@ez-agents/bin/ez-tools.cjs
-</context>
-
-<process>
-## Subcommand Routing
-
-1. **Parse arguments** — First arg is subcommand (save/list/delete/test), remaining are parameters
-2. **Route to handler** — Call appropriate auth function from ez-tools.cjs
-3. **Output result** — Show success/failure with user-friendly messages
-
-## Handlers
-
-### save <provider> <secret>
-1. Validate provider name against known providers
-2. Call saveCredential(provider, secret)
-3. Output: "✓ Credential saved for {provider}" or error message
-
-### list
-1. Call listProviders()
-2. Check isKeychainAvailable()
-3. Output table:
-   ```
-   Provider       Storage
-   ─────────────────────────
-   anthropic      Keychain ✓
-   qwen           File (fallback)
-   ```
-4. If using file storage, show warning: "⚠ Using file storage — consider installing keytar for better security"
-
-### delete <provider>
-1. Validate provider exists
-2. Confirm deletion (ask user or require --force)
-3. Call deleteCredential(provider)
-4. Output: "✓ Credential deleted for {provider}"
-
-### test
-1. Check isKeychainAvailable()
-2. Output:
-   ```
-   Credential System Test
-   
-   Keychain (keytar): {Available | Unavailable}
-   Storage mode: {System keychain | Fallback file}
-   
-   Stored providers: {count}
-   ```
-3. If keytar unavailable, show install hint: "npm install keytar"
-
-## Error Handling
-
-- **Invalid provider:** "Unknown provider '{name}'. Valid: anthropic, moonshot, alibaba, qwen, openai"
-- **Credential not found:** "No credential found for {provider}. Use 'save' to add one."
-- **Keychain error:** "Failed to access keychain: {error}. Using fallback storage."
-</process>

package/commands/ez/autonomous.md

@@ -1,41 +0,0 @@
----
-name: ez:autonomous
-description: Run all remaining phases autonomously — discuss→plan→execute per phase
-argument-hint: "[--from N]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - AskUserQuestion
-  - Task
----
-<objective>
-Execute all remaining milestone phases autonomously. For each phase: discuss → plan → execute. Pauses only for user decisions (grey area acceptance, blockers, validation requests).
-
-Uses ROADMAP.md phase discovery and Skill() flat invocations for each phase command. After all phases complete: milestone audit → complete → cleanup.
-
-**Creates/Updates:**
-- `.planning/STATE.md` — updated after each phase
-- `.planning/ROADMAP.md` — progress updated after each phase
-- Phase artifacts — CONTEXT.md, PLANs, SUMMARYs per phase
-
-**After:** Milestone is complete and cleaned up.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/autonomous.md
-@~/.claude/ez-agents/references/ui-brand.md
-</execution_context>
-
-<context>
-Optional flag: `--from N` — start from phase N instead of the first incomplete phase.
-
-Project context, phase list, and state are resolved inside the workflow using init commands (`ez-tools.cjs init milestone-op`, `ez-tools.cjs roadmap analyze`). No upfront context loading needed.
-</context>
-
-<process>
-Execute the autonomous workflow from @~/.claude/ez-agents/workflows/autonomous.md end-to-end.
-Preserve all workflow gates (phase discovery, per-phase execution, blocker handling, progress display).
-</process>

package/commands/ez/check-todos.md

@@ -1,45 +0,0 @@
----
-name: ez:check-todos
-description: List pending todos and select one to work on
-argument-hint: [area filter]
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - AskUserQuestion
----
-
-<objective>
-List all pending todos, allow selection, load full context for the selected todo, and route to appropriate action.
-
-Routes to the check-todos workflow which handles:
-- Todo counting and listing with area filtering
-- Interactive selection with full context loading
-- Roadmap correlation checking
-- Action routing (work now, add to phase, brainstorm, create phase)
-- STATE.md updates and git commits
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/check-todos.md
-</execution_context>
-
-<context>
-Arguments: $ARGUMENTS (optional area filter)
-
-Todo state and roadmap correlation are loaded in-workflow using `init todos` and targeted reads.
-</context>
-
-<process>
-**Follow the check-todos workflow** from `@~/.claude/ez-agents/workflows/check-todos.md`.
-
-The workflow handles all logic including:
-1. Todo existence checking
-2. Area filtering
-3. Interactive listing and selection
-4. Full context loading with file summaries
-5. Roadmap correlation checking
-6. Action offering and execution
-7. STATE.md updates
-8. Git commits
-</process>

package/commands/ez/cleanup.md

@@ -1,18 +0,0 @@
----
-name: ez:cleanup
-description: Archive accumulated phase directories from completed milestones
----
-<objective>
-Archive phase directories from completed milestones into `.planning/milestones/v{X.Y}-phases/`.
-
-Use when `.planning/phases/` has accumulated directories from past milestones.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/cleanup.md
-</execution_context>
-
-<process>
-Follow the cleanup workflow at @~/.claude/ez-agents/workflows/cleanup.md.
-Identify completed milestones, show a dry-run summary, and archive on confirmation.
-</process>

package/commands/ez/debug.md

@@ -1,168 +0,0 @@
----
-name: ez:debug
-description: Systematic debugging with persistent state across context resets
-argument-hint: [issue description]
-allowed-tools:
-  - Read
-  - Bash
-  - Task
-  - AskUserQuestion
----
-
-<objective>
-Debug issues using scientific method with subagent isolation.
-
-**Orchestrator role:** Gather symptoms, spawn ez-debugger agent, handle checkpoints, spawn continuations.
-
-**Why subagent:** Investigation burns context fast (reading files, forming hypotheses, testing). Fresh 200k context per investigation. Main context stays lean for user interaction.
-</objective>
-
-<context>
-User's issue: $ARGUMENTS
-
-Check for active sessions:
-```bash
-ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
-```
-</context>
-
-<process>
-
-## 0. Initialize Context
-
-```bash
-INIT=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" state load)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Extract `commit_docs` from init JSON. Resolve debugger model:
-```bash
-debugger_model=$(node "$HOME/.claude/ez-agents/bin/ez-tools.cjs" resolve-model ez-debugger --raw)
-```
-
-## 1. Check Active Sessions
-
-If active sessions exist AND no $ARGUMENTS:
-- List sessions with status, hypothesis, next action
-- User picks number to resume OR describes new issue
-
-If $ARGUMENTS provided OR user describes new issue:
-- Continue to symptom gathering
-
-## 2. Gather Symptoms (if new issue)
-
-Use AskUserQuestion for each:
-
-1. **Expected behavior** - What should happen?
-2. **Actual behavior** - What happens instead?
-3. **Error messages** - Any errors? (paste or describe)
-4. **Timeline** - When did this start? Ever worked?
-5. **Reproduction** - How do you trigger it?
-
-After all gathered, confirm ready to investigate.
-
-## 3. Spawn ez-debugger Agent
-
-Fill prompt and spawn:
-
-```markdown
-<objective>
-Investigate issue: {slug}
-
-**Summary:** {trigger}
-</objective>
-
-<symptoms>
-expected: {expected}
-actual: {actual}
-errors: {errors}
-reproduction: {reproduction}
-timeline: {timeline}
-</symptoms>
-
-<mode>
-symptoms_prefilled: true
-goal: find_and_fix
-</mode>
-
-<debug_file>
-Create: .planning/debug/{slug}.md
-</debug_file>
-```
-
-```
-Task(
-  prompt=filled_prompt,
-  subagent_type="ez-debugger",
-  model="{debugger_model}",
-  description="Debug {slug}"
-)
-```
-
-## 4. Handle Agent Return
-
-**If `## ROOT CAUSE FOUND`:**
-- Display root cause and evidence summary
-- Offer options:
-  - "Fix now" - spawn fix subagent
-  - "Plan fix" - suggest /ez:plan-phase --gaps
-  - "Manual fix" - done
-
-**If `## CHECKPOINT REACHED`:**
-- Present checkpoint details to user
-- Get user response
-- If checkpoint type is `human-verify`:
-  - If user confirms fixed: continue so agent can finalize/resolve/archive
-  - If user reports issues: continue so agent returns to investigation/fixing
-- Spawn continuation agent (see step 5)
-
-**If `## INVESTIGATION INCONCLUSIVE`:**
-- Show what was checked and eliminated
-- Offer options:
-  - "Continue investigating" - spawn new agent with additional context
-  - "Manual investigation" - done
-  - "Add more context" - gather more symptoms, spawn again
-
-## 5. Spawn Continuation Agent (After Checkpoint)
-
-When user responds to checkpoint, spawn fresh agent:
-
-```markdown
-<objective>
-Continue debugging {slug}. Evidence is in the debug file.
-</objective>
-
-<prior_state>
-<files_to_read>
-- .planning/debug/{slug}.md (Debug session state)
-</files_to_read>
-</prior_state>
-
-<checkpoint_response>
-**Type:** {checkpoint_type}
-**Response:** {user_response}
-</checkpoint_response>
-
-<mode>
-goal: find_and_fix
-</mode>
-```
-
-```
-Task(
-  prompt=continuation_prompt,
-  subagent_type="ez-debugger",
-  model="{debugger_model}",
-  description="Continue debug {slug}"
-)
-```
-
-</process>
-
-<success_criteria>
-- [ ] Active sessions checked
-- [ ] Symptoms gathered (if new)
-- [ ] ez-debugger spawned with context
-- [ ] Checkpoints handled correctly
-- [ ] Root cause confirmed before fixing
-</success_criteria>

package/commands/ez/health.md

@@ -1,22 +0,0 @@
----
-name: ez:health
-description: Diagnose planning directory health and optionally repair issues
-argument-hint: [--repair]
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - AskUserQuestion
----
-<objective>
-Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/health.md
-</execution_context>
-
-<process>
-Execute the health workflow from @~/.claude/ez-agents/workflows/health.md end-to-end.
-Parse --repair flag from arguments and pass to workflow.
-</process>

package/commands/ez/insert-phase.md

@@ -1,32 +0,0 @@
----
-name: ez:insert-phase
-description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
-argument-hint: <after> <description>
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Insert a decimal phase for urgent work discovered mid-milestone that must be completed between existing integer phases.
-
-Uses decimal numbering (72.1, 72.2, etc.) to preserve the logical sequence of planned phases while accommodating urgent insertions.
-
-Purpose: Handle urgent work discovered during execution without renumbering entire roadmap.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/insert-phase.md
-</execution_context>
-
-<context>
-Arguments: $ARGUMENTS (format: <after-phase-number> <description>)
-
-Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool calls.
-</context>
-
-<process>
-Execute the insert-phase workflow from @~/.claude/ez-agents/workflows/insert-phase.md end-to-end.
-Preserve all validation gates (argument parsing, phase verification, decimal calculation, roadmap updates).
-</process>

package/commands/ez/join-discord.md

@@ -1,18 +0,0 @@
----
-name: ez:join-discord
-description: Join the EZ Agents Discord community
----
-
-<objective>
-Display the Discord invite link for the EZ Agents community server.
-</objective>
-
-<output>
-# Join the EZ Agents Discord
-
-Connect with other EZ Agents users, get help, share what you're building, and stay updated.
-
-**Invite link:** https://discord.gg/ez-agents
-
-Click the link or paste it into your browser to join.
-</output>

package/commands/ez/list-phase-assumptions.md

@@ -1,46 +0,0 @@
----
-name: ez:list-phase-assumptions
-description: Surface Claude's assumptions about a phase approach before planning
-argument-hint: "[phase]"
-allowed-tools:
-  - Read
-  - Bash
-  - Grep
-  - Glob
----
-
-<objective>
-Analyze a phase and present Claude's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
-
-Purpose: Help users see what Claude thinks BEFORE planning begins - enabling course correction early when assumptions are wrong.
-Output: Conversational output only (no file creation) - ends with "What do you think?" prompt
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/list-phase-assumptions.md
-</execution_context>
-
-<context>
-Phase number: $ARGUMENTS (required)
-
-Project state and roadmap are loaded in-workflow using targeted reads.
-</context>
-
-<process>
-1. Validate phase number argument (error if missing or invalid)
-2. Check if phase exists in roadmap
-3. Follow list-phase-assumptions.md workflow:
-   - Analyze roadmap description
-   - Surface assumptions about: technical approach, implementation order, scope, risks, dependencies
-   - Present assumptions clearly
-   - Prompt "What do you think?"
-4. Gather feedback and offer next steps
-</process>
-
-<success_criteria>
-
-- Phase validated against roadmap
-- Assumptions surfaced across five areas
-- User prompted for feedback
-- User knows next steps (discuss context, plan phase, or correct assumptions)
-  </success_criteria>

package/commands/ez/pause-work.md

@@ -1,38 +0,0 @@
----
-name: ez:pause-work
-description: Create context handoff when pausing work mid-phase
-allowed-tools:
-  - Read
-  - Write
-  - Bash
----
-
-<objective>
-Create `.continue-here.md` handoff file to preserve complete work state across sessions.
-
-Routes to the pause-work workflow which handles:
-- Current phase detection from recent files
-- Complete state gathering (position, completed work, remaining work, decisions, blockers)
-- Handoff file creation with all context sections
-- Git commit as WIP
-- Resume instructions
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/pause-work.md
-</execution_context>
-
-<context>
-State and phase progress are gathered in-workflow with targeted reads.
-</context>
-
-<process>
-**Follow the pause-work workflow** from `@~/.claude/ez-agents/workflows/pause-work.md`.
-
-The workflow handles all logic including:
-1. Phase directory detection
-2. State gathering with user clarifications
-3. Handoff file writing with timestamp
-4. Git commit
-5. Confirmation with resume instructions
-</process>

package/commands/ez/plan-milestone-gaps.md

@@ -1,34 +0,0 @@
----
-name: ez:plan-milestone-gaps
-description: Create phases to close all gaps identified by milestone audit
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - AskUserQuestion
----
-<objective>
-Create all phases necessary to close gaps identified by `/ez:audit-milestone`.
-
-Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase.
-
-One command creates all fix phases — no manual `/ez:add-phase` per gap.
-</objective>
-
-<execution_context>
-@~/.claude/ez-agents/workflows/plan-milestone-gaps.md
-</execution_context>
-
-<context>
-**Audit results:**
-Glob: .planning/v*-MILESTONE-AUDIT.md (use most recent)
-
-Original intent and current planning state are loaded on demand inside the workflow.
-</context>
-
-<process>
-Execute the plan-milestone-gaps workflow from @~/.claude/ez-agents/workflows/plan-milestone-gaps.md end-to-end.
-Preserve all workflow gates (audit loading, prioritization, phase grouping, user confirmation, roadmap updates).
-</process>