markdown-ticket: Skill for Claude Code

Ticket Pipeline E2E

Run one ticket from intent to reviewed implementation. Own the control loop; load project docs, project-local skills, references, and tools only when needed.

Start Here

1. Read root instructions and ticket docs.
2. Run this skill's scripts/discover_project.sh <repo-root> [ticket] when shell access is available.
3. Resolve the ticket source, artifact directory, current status, and existing artifacts.
4. Write or update .pipeline-state.json in the ticket artifact directory.
5. Run baseline verification from project docs or discovered package scripts.
6. Start the milestone matrix below.

Core Rules

• Prefer project docs over this generic skill for paths, commands, statuses, durable docs, and verification.
• Read docs/SKILLS.md when present before selecting helper skills.
• Do not hardcode MDT commands unless the project documents MDT or the user says "use MDT flow".
• Never close a ticket without explicit user approval.
• Keep the worktree scoped; never stash, reset, stage, or rewrite unrelated user changes.
• Record enough state on disk to resume after context loss.

Discovery Record

Record this before milestone 1:

Project docs: <files read>
Ticket source: <key/url/path/description>
Artifact directory: <path>
Ticket status model: <states and transition command, or none>
Workflow skills/tools: <project-local first, global fallback>
Language/runtime: <detected stack and selected references>
Verification commands: <baseline build/test/lint/docs commands>
Dirty worktree boundary: <unrelated files to avoid, or none>

State file shape:

{
  "pipeline": "mdt-pipeline-e2e",
  "version": 4,
  "ticket": "<ticket key or source>",
  "currentMilestone": "pre-flight",
  "completedMilestones": [],
  "discovery": {},
  "artifacts": {},
  "baseline": {},
  "approvals": {},
  "commits": [],
  "updatedAt": "<ISO8601>"
}

References

Load only what applies:

Reference	Load when
references/mdt-workflow.md	User says "use MDT flow" or MDT stage skills are available
references/ux-gate.md	UI, interaction, content, visual, or durable design-doc changes
references/ralph-loop.md	Ralph tools or equivalent milestone protocol are available
references/language-typescript.md	TypeScript, JavaScript, Node, Bun, npm, pnpm, yarn, React
references/language-python.md	Python, Django, Flask, FastAPI, pytest, uv, Poetry
references/language-rust.md	Rust, Cargo, crates, clippy
references/language-go.md	Go modules, go test, go vet