RePPIT workflow coach · local-first · tool-agnostic

Steer AI coding agents
before they make a mess.

A local-first CLI + Claude Code plugin that coaches engineers and non-technical builders through a disciplined workflow — Research, Propose, Plan, Implement, Test.

“Like a calm senior engineer sitting next to you in the terminal.”

~/my-project — bash
The foundation

What breaks agents

Everything your team works around is something that breaks an agent. Took audits your repo for exactly these gaps and frames every finding as a fixable thing.

No tests
Agent can't verify its own changes
Add tests before you start. Took tells you which.
Inconsistent patterns
Agent picks the wrong one and spreads it
Document your conventions in AGENTS.md
Stale context docs
Agent hallucinates APIs that changed
Took flags docs/playbook drift after every diff
No hermetic build
Agent can't tell if it broke anything
`took ready` surfaces build + lint gaps
Vague AGENTS.md
Agent invents rules you didn't intend
Took helps you write a machine-readable playbook
Context overrun
Quality collapses in the "dumb zone"
Took warns before you hit ~170K tokens

$ took ready — runs an agent-readiness audit on your repo and produces a prioritised fix list. Free, local, no account needed.

The methodology

The RePPIT loop

Research → Propose → Plan → Implement → Test. The six-step discipline that turns vague prompts into production-grade, verifiable code — and coaches you through every stage.

R
Research

Produce the document the agent plans from. No research → no plan → slop.

P
Propose

Force alternatives. Only one solution considered is a red flag.

P
Plan

A reviewable spec with a verifiable done. The agent's contract.

I
Implement

Externalise progress on large tasks. Protect the context budget.

T
Test

Favour automatic verification. Missing tests = untrusted code.

add-on
S
Secure

Pipp Health only. HIPAA/SOC2/HITRUST gate after Test.

RResearch

Before the agent touches code, you (or Took) generate a research artifact: current API docs, existing patterns, affected files. Without it the agent hallucinates.

PPropose

Took coaches you to produce at least two or three approaches with trade-offs before committing. Alternatives prevent tunnel vision and surface risk early.

PPlan

A plan document scopes the diff before it happens: files in scope, files off-limits, acceptance criteria. Took checks the agent stays inside the lines.

IImplement

Took guards each tool call — scope blowouts, dangerous commands, near-dumb-zone context warnings. Large tasks checkpoint progress to artifacts so nothing is lost to compaction.

TTest

Took's diff check catches missing test coverage and flags risky untested diffs. PR readiness scores tests as a first-class signal.

SSecurePipp Health

In regulated mode, a sixth gate runs compliance checklists against the diff. Loop Implement → Test → Secure until clean. A green diff never auto-passes what code can't prove.

Right-sizing

Two-axis governor

Over-coaching is a failure mode too. Took scales how closely it watches to the task and the operator — so a one-line fix never gets the full loop, and a healthcare migration never skips the Secure gate.

Axis 1

Rigor ↔ Task Size

A one-line fix gets a light touch. A cross-service migration gets the full loop. Took never over-coaches trivia or under-coaches complexity.

Trivial·rename a variable
Just do it
Small·add a field
Plan only
Medium·new feature
Full RePPIT
Large·migration
RePPIT + checkpoints
Axis 2

Protection ↔ Operator

Engineers get Took in Coach mode. Non-technical builders default to Guard/Strict. Regulated teams get the Secure gate. Right-sized, not maximum.

Engineer·experienced dev
Coach (warn-only)
Builder·non-technical
Guard (confirm)
Regulated·healthcare team
Strict + Secure
Team·shared rules
Policy-controlled
The layers

One coach, three layers

Took is free for engineers. Pipp extends it for builders who want to understand what they're managing. Pipp Health adds regulated-industry compliance for healthcare teams.

Took

Engineer Core
Freelocal CLI · forever

Steer AI coding agents before they make a mess.

  • RePPIT workflow coaching
  • Pre-tool guard + diff review
  • Agent-readiness audit
  • Docs & playbook drift check
  • PR readiness score
  • Local XP ledger
Install free

Pipp

Education Layer
$6–12per month · Pro

Build with AI and actually understand what's happening.

  • Plain-English narration of every agent action
  • Leveled, cited learning resources
  • Heightened scanning & guardrails
  • Concept tracking — stops re-explaining
  • Learning XP + profile
  • Free taste (N explanations/day)
Learn about Pipp

Pipp Health

Regulated Add-on
Add-onper seat · enterprise

Ship healthcare software with compliance checks built into the workflow.

  • Secure phase (RePPITS loop)
  • HIPAA / SOC 2 / HITRUST assessment
  • PHI/PII standing scan
  • Code-verifiable vs org controls
  • Retained compliance audit trail
  • Composable with Pipp
Explore Pipp Health
Claude Code

Install in your agent

Took works as a Claude Code plugin — hooking into UserPromptSubmit, PreToolUse, PostToolUse, and PreCompact events to coach without interrupting your flow.

claude-code — plugin install
# Claude Code plugin marketplace
$ /plugin marketplace add gettook/took
Found: Took v0.9.1 · coaching hooks for Claude Code
$ /plugin install took@took
UserPromptSubmit hook · registered ✓
PreToolUse hook · registered ✓
PostToolUse hook · registered ✓
PreCompact hook · registered ✓
Took is watching. A coach, never an agent.
$
UserPromptSubmit
Right-sizes the prompt and coaches Research-first for non-trivial tasks.
PreToolUse
Guards scope blowouts, dangerous commands, and context budget warnings.
PostToolUse
Reviews the diff for missing tests, docs drift, and out-of-scope edits.
PreCompact
Encourages caching progress to an artifact before context compaction.
Took XP

Judgment rewarded, not tokens burned

Took XP rewards quality, judgment, and learning — never prompt count, diff size, or token volume. Right-sizing a task earns a Judgment bonus. Running the full loop when it was warranted earns Research, Plan, and Test XP.

Anti-gaming: per-category daily caps, evidence required (real artifacts, tests, surviving PRs), and improvement deltas rewarded over absolutes — so messy starters are rewarded for growth.

Research+25 XP

Generated a research doc before prompting

Plan+20 XP

Scoped the diff with a verifiable done

Guard+15 XP

Prevented a dangerous out-of-scope edit

Test+20 XP

All changed files have test coverage

Judgment+30 XP

Right-sized a trivial task, skipped loop

Learning+10 XP

Mastered a new concept via Pipp

Agent-ready ✓ score badge for your README
·
Compliance XP for Pipp Health
·
Portfolio export for non-technical builders

Start steering your agents.

Free local CLI. No account. No cloud. No surveillance. Just a calm senior engineer in your terminal.