ai-stack: Skill for Claude Code

Single-Flow Task Execution

Execute plans by working through one task at a time with two-stage review after each: spec compliance review first, then code quality review.

Core principle: One task at a time + two-stage review (spec then quality) = high quality, disciplined iteration.

Antigravity Execution Model

Antigravity does NOT support parallel coding subagents. All work happens in a single execution thread.

Rules:

1. One active task only — never work on multiple tasks simultaneously.
2. One execution thread only — no parallel dispatch.
3. No parallel coding subagents — Antigravity does not have Task(...).
4. Browser automation may use browser_subagent in isolated steps.
5. Track progress by updating <project-root>/docs/plans/task.md at each state change (table-only tracker).
6. Use task_boundary to clearly delineate each unit of work.

When to Use

digraph when_to_use {
    "Have implementation plan?" [shape=diamond];
    "Tasks mostly independent?" [shape=diamond];
    "Multiple problems to solve?" [shape=diamond];
    "single-flow-task-execution" [shape=box];
    "executing-plans" [shape=box];
    "Manual execution or brainstorm first" [shape=box];

    "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
    "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
    "Tasks mostly independent?" -> "single-flow-task-execution" [label="yes"];
    "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
    "Multiple problems to solve?" -> "single-flow-task-execution" [label="yes - work through them sequentially"];
    "Multiple problems to solve?" -> "Manual execution or brainstorm first" [label="no - single task"];
}

Use when:

• You have an implementation plan with multiple independent tasks
• 2+ test files failing with different root causes (work through them one at a time)
• Multiple subsystems broken independently
• Each problem can be understood without context from others
• Structured execution with quality gates is needed