Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions agents/gsd-executor.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,16 @@ Track auto-fix attempts per task. After 3 auto-fix attempts on a single task:
- Do NOT restart the build to find more issues
</deviation_rules>

<analysis_paralysis_guard>
**During task execution, if you make 5+ consecutive Read/Grep/Glob calls without any Edit/Write/Bash action:**

STOP. State in one sentence why you haven't written anything yet. Then either:
1. Write code (you have enough context), or
2. Report "blocked" with the specific missing information.

Do NOT continue reading. Analysis without action is a stuck signal.
</analysis_paralysis_guard>

<authentication_gates>
**Auth errors during `type="auto"` execution are gates, not failures.**

Expand Down
2 changes: 2 additions & 0 deletions agents/gsd-plan-checker.md
Original file line number Diff line number Diff line change
Expand Up @@ -445,6 +445,8 @@ Session persists | 01 | 3 | COVERED

For each requirement: find covering task(s), verify action is specific, flag gaps.

**Exhaustive cross-check:** Also read PROJECT.md requirements (not just phase goal). Verify no PROJECT.md requirement relevant to this phase is silently dropped. Any unmapped requirement is an automatic blocker — list it explicitly in issues.

## Step 5: Validate Task Structure

Use gsd-tools plan-structure verification (already run in Step 2):
Expand Down
20 changes: 20 additions & 0 deletions agents/gsd-planner.md
Original file line number Diff line number Diff line change
Expand Up @@ -234,6 +234,26 @@ This prevents the "scavenger hunt" anti-pattern where executors explore the code

**Why TDD gets own plan:** TDD requires RED→GREEN→REFACTOR cycles consuming 40-50% context. Embedding in multi-task plans degrades quality.

**Task-level TDD** (for code-producing tasks in standard plans): When a task creates or modifies production code, add `tdd="true"` and a `<behavior>` block to make test expectations explicit before implementation:

```xml
<task type="auto" tdd="true">
<name>Task: [name]</name>
<files>src/feature.ts, src/feature.test.ts</files>
<behavior>
- Test 1: [expected behavior]
- Test 2: [edge case]
</behavior>
<action>[Implementation after tests pass]</action>
<verify>
<automated>npm test -- --filter=feature</automated>
</verify>
<done>[Criteria]</done>
</task>
```

Exceptions where `tdd="true"` is not needed: `type="checkpoint:*"` tasks, configuration-only files, documentation, migration scripts, glue code wiring existing tested components, styling-only changes.

## User Setup Detection

For tasks involving external services, identify human-required configuration:
Expand Down
Loading