Skip to content

P1: Sprint v0 / hotfix / refactor / spike lifecycle carve-outs #30

@ramdhanyk

Description

@ramdhanyk

Source: 2026-04-20 multi-expert AADM audit. Methodology auditor.

Problem

tooling/.claude/skills/prd.md:25 refuses if "the previous sprint has no .lock." No carve-out for v1 (where there is no previous sprint).

No /hotfix skill — sprint_gate.py will block a P0 production fix in sprints/v3/ if v2/.lock is missing for any reason.

No /refactor skill — /dev requires a Satisfies: line citing requirement IDs, but a pure refactor satisfies no design-doc ID. Engineers either fabricate or skip the method.

No /spike skill — method doc explicitly excludes spikes (method/.../v3_2_1.md:58-64) but provides no workflow at all.

Fix

  • prd.md: add v1-bootstrap exception ("no previous sprint" passes the gate; require Phase-0 design-doc-signed-off marker instead).
  • tooling/.claude/skills/hotfix.md: explicit gate bypass + required follow-up retro entry naming the bypass.
  • tooling/.claude/skills/refactor.md: allows Satisfies: TECH-DEBT-N from a docs/tech-debt.md registry.
  • tooling/.claude/skills/spike.md: timeboxed, output is a decision memo, no Satisfies: requirement.

Acceptance

All four lifecycles (v1 bootstrap, hotfix, refactor-only sprint, spike) have a documented runnable path. prd.md cleanly handles v1.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P1High — honest scope, lifecycle gap, or regulated table-stakesaudit-followupFrom the 2026-04-20 multi-expert AADM audit

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions