Agent spawn hook: accept project- reference for board-driven projects #200

New issue

Closed

opened 2026-03-24 17:03:28 +00:00 by forgejo_admin · 0 comments

forgejo_admin commented

2026-03-24 17:03:28 +00:00

Contributor

Type

Bug

Lineage

Standalone — board-pal-e-agency process improvement

Repo

~/claude-custom (hooks are hardlinked to ~/.claude/hooks/)

What Broke

check-agent-spawn.sh blocks agent spawns for board-driven projects that don't have plans. The general-purpose and dottie agent types require plan- in the prompt, but projects like svelte-playground are board-driven and reference project- instead.

Repro Steps

Create a board-driven project with no plan (e.g., svelte-playground)
Try to spawn a general-purpose agent with project-svelte-playground in the prompt
Hook denies: "Agent type general-purpose requires pattern: plan-"

Expected Behavior

Agent spawn should accept either plan- OR project- as a valid scope reference. Board-driven projects are a legitimate workflow — not every project needs a plan.

Environment

~/.claude/schemas/agent-spawn-requirements.json line 18 and 23: "required_patterns": ["plan-"]
~/.claude/hooks/check-agent-spawn.sh uses grep -qE against these patterns

Acceptance Criteria

Agent spawn with plan-pal-e-docs in prompt still passes
Agent spawn with project-svelte-playground in prompt now passes
Agent spawn with neither plan- nor project- still fails

project-pal-e-agency — agent spawn conventions
agent-spawn-conventions — the SOP this enforces

### Type Bug ### Lineage Standalone — board-pal-e-agency process improvement ### Repo `~/claude-custom` (hooks are hardlinked to `~/.claude/hooks/`) ### What Broke `check-agent-spawn.sh` blocks agent spawns for board-driven projects that don't have plans. The `general-purpose` and `dottie` agent types require `plan-` in the prompt, but projects like svelte-playground are board-driven and reference `project-` instead. ### Repro Steps 1. Create a board-driven project with no plan (e.g., svelte-playground) 2. Try to spawn a `general-purpose` agent with `project-svelte-playground` in the prompt 3. Hook denies: "Agent type general-purpose requires pattern: plan-" ### Expected Behavior Agent spawn should accept either `plan-` OR `project-` as a valid scope reference. Board-driven projects are a legitimate workflow — not every project needs a plan. ### Environment - `~/.claude/schemas/agent-spawn-requirements.json` line 18 and 23: `"required_patterns": ["plan-"]` - `~/.claude/hooks/check-agent-spawn.sh` uses grep -qE against these patterns ### Acceptance Criteria - [ ] Agent spawn with `plan-pal-e-docs` in prompt still passes - [ ] Agent spawn with `project-svelte-playground` in prompt now passes - [ ] Agent spawn with neither `plan-` nor `project-` still fails ### Related - `project-pal-e-agency` — agent spawn conventions - `agent-spawn-conventions` — the SOP this enforces