# Guide TDD Workflow Checkpoints

Teams often lose task status, test discipline, and commit traceability during implementation. This skill guides Claude, Codex, and Claude Code through TDD tasks, verification gates, and checkpoint commits.

## Install

```bash
npx skillstore add wshobson/workflow-patterns
```

## Metadata

- Status: approved
- Slug: wshobson-workflow-patterns
- Version: 1.0.0
- Author version: 1.0.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: 34b3679b86e1b9276fb06e6d87fb997149e15411c4a1e6b86b4d93c9fb0b2060
- Author: wshobson
- GitHub username: wshobson
- License: MIT
- Repository: https://github.com/wshobson/agents/tree/main/plugins/conductor/skills/workflow-patterns/
- Ref: 64ca8af0f54a325752f08bd54e52151061ea659a
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 79
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/wshobson-workflow-patterns
- Manifest: https://skillstore.pages.dev/api/skills/wshobson-workflow-patterns/manifest

## Capabilities

- Selects the next pending plan task and marks it in progress.
- Guides red, green, and refactor work with tests first.
- Runs coverage, linting, type checks, and full test suites at checkpoints.
- Creates focused git commits, git notes, and SHA references.
- Documents deviations, blockers, and checkpoint approvals in plan files.

## Use Cases

- Implement Plan Tasks: Follow a repeatable TDD cycle while moving through tasks in a Conductor plan.
- Verify Phase Readiness: Check tests, coverage, manual verification items, and approval status before advancing a phase.
- Recover From Failed Checks: Document failures, return to a known green state, and create remediation tasks for rejected checkpoints.

## Prompt Templates

### Start Next Task

```
Use workflow-patterns to find the next pending task in plan.md, mark it in progress, and begin with failing tests.
```

### Complete a TDD Cycle

```
Use workflow-patterns for this task. Write failing tests, implement the minimum fix, refactor safely, and report the verification commands you ran.
```

### Prepare a Phase Checkpoint

```
Use workflow-patterns to verify all phase tasks, run coverage and quality gates, create manual verification steps, and wait for approval.
```

### Handle a Deviation or Rejection

```
Use workflow-patterns to document this deviation, update the plan and spec if needed, create remediation tasks, and retry checkpoint approval.
```

## Limitations

- It does not provide a test framework or execute checks without tool access.
- It assumes the project uses Conductor track files such as plan.md.
- It depends on user approval before moving past phase checkpoints.
- It cannot guarantee coverage targets if the project lacks measurable tests.

## Best Practices

- Keep each task in a clean TDD cycle before starting another task.
- Commit status changes, implementation work, and plan updates as separate logical changes.
- Request explicit user approval before creating or advancing checkpoint commits.

## Anti Patterns

- Skipping failing tests and implementing directly.
- Combining unrelated task work in a single commit.
- Marking a phase complete before coverage and manual checks are reviewed.

## Security Audit

- Audited at: 2026-07-08T12:17:37.286\+00:00
- Summary: Static analysis flagged Markdown backticks and checklist phrases in SKILL.md. Review found local git, test, coverage, lint, and checkpoint examples only. No executable code, dynamic command construction, exfiltration intent, reconnaissance behavior, or prompt injection attempt was found.

## Stats

- Views: 169
- Downloads: 12
- Favorites: 0
- Popularity score: 0