impstack

impstack, imperfect operator.

This is my opinionated blueprint for a personal code factory. I connect its order book, workstations, review lanes, release, and retro in one line.

I am the imperfect part it is designed around. I add hand-off points and explanation gates where speed tempts me to accept work that I have stopped following.

install

git clone https://github.com/ivankqw/agents-cfg.git ~/agents-cfg
~/agents-cfg/bootstrap.sh

get started

the factory floor

flowchart LR
    LI["Linear<br/>order book<br/>issues and maps"] --> HE["Herdr<br/>the floor<br/>Codex lanes in panes"]
    HE --> WT["Worktree pool<br/>workstations<br/>wt + treehouse<br/>seeded and torn down"]
    WT --> DL
    WT --> SL
    subgraph QA["QA: two review lanes"]
        direction TB
        DL["Fresh Sonnet<br/>default defects lane"]
        SL["Standards and spec lane"]
    end
    DL --> MR["Merge and release<br/>operator tags"]
    SL --> MR
    MR --> RE["backpass / reflect<br/>retro<br/>transcript findings<br/>operator-gated convention and skill edits"]
    RE --> OP["Operator<br/>hand-off point<br/>explanation gates<br/>planned"]
    HA["Harness<br/>Claude Code or Codex<br/>Hermes experimental"] -. runs .-> HE
    EX["Executor<br/>agent-connection catalogue"] -. supplies tools .-> HE
    SK["Skills<br/>method cards<br/>pstack + Matt Pocock"] -. guide .-> HE

principle	station	tool	fixed or flexible	where configured
Start from an order	Order book	Linear issues and maps	Fixed	`mcp/servers.json` and the private layer
Keep implementation visible	Factory floor	Herdr with Codex lanes in panes	Fixed	Private layer
Isolate each checkout	Workstations	Worktree pool with `wt` and treehouse, seeded and torn down	Fixed	Private layer
Change the blind spots	QA	Fresh Sonnet default defects lane and standards/spec lane	Fixed	`conventions/AGENTS.md` and `configs/`
Keep release judgment human	Merge and release	Operator tags	Fixed	Private layer
Feed corrections back	Retro	backpass and `reflect` surface transcript findings for operator-gated convention and skill edits	Fixed	`conventions/AGENTS.md`, `pstack-revision.txt`, and the private layer
Return control at junctions	Hand-off point	Operator explanation gates, planned	Fixed	Private layer
Choose the runtime per environment	Supporting layer: harness	Claude Code or Codex; Hermes is experimental `[unverified]`	Flexible	`configs/`, `settings/`, and the private layer
Carry one tool catalogue	Supporting layer: agent connections	Executor Cloud through MCP	Fixed	`mcp/servers.json`
Load the method when needed	Supporting layer: skills	pstack and Matt Pocock's skills	Fixed	`pstack-revision.txt`, `bootstrap.sh`, and `skills-catalog.json`

usage

I run these from my full machine setup. The portable bootstrap does not install the Herdr or backpass runtimes. [sourced: bootstrap.sh]

herdr agent prompt codex "Take this lane's issue brief. Use the implement skill, then open a draft PR." --wait

I run the standards lane from Claude Code.

/code-review origin/main

backpass scan --since 7d --strict
backpass

skills

I write a skill when no upstream skill covers the job.

Skills I own

skill	job
`cleanup-crew`	Keep the issue tracker aligned with current work.
`dogfood-local`	Run a local app and verify the real user path.

Upstream skills by source

source and credit	skills
pstack by Lauren "poteto" Tan, contributors, and Michael Denyer's Claude port	Routing, review, verification, agent workflows, and engineering principles.
Herdr	`herdr`.
Matt Pocock	`ask-matt`, `code-review`, `codebase-design`, `diagnosing-bugs`, `domain-modeling`, `grill-me`, `grill-with-docs`, `grilling`, `handoff`, `implement`, `improve-codebase-architecture`, `prototype`, `research`, `resolving-merge-conflicts`, `setup-matt-pocock-skills`, `tdd`, `teach`, `to-questionnaire`, `to-spec`, `to-tickets`, `triage`, `wait-what`, `wayfinder`, `wizard`, `writing-for-agents`.
Vercel Labs	`find-skills`.
Cursor	`deslop`.
Hardik Pandya	`stop-slop`.
Microsoft	`microsoft-foundry`.
shadcn	`improve`.
Leon	`brandkit`, `design-taste-frontend`, `high-end-visual-design`, `imagegen-frontend-mobile`, `imagegen-frontend-web`, `image-to-code`, `redesign-existing-projects`.
Peter Bakaus	`impeccable`.
Aiden Bai	`improve-react`.
Saurabh Kumar	`cyclomatic-complexity`.
Dietrich Gebert	`ponytail-audit`, `ponytail-debt`, `ponytail-gain`, `ponytail-help`, `ponytail-review`.

docs

Thesis explains the personal overfitting argument.
How it works explains each layer and its source file.
Install installs, verifies, updates, and removes the setup.
Credits names upstream authors, sources, and licenses.
Maintaining gives repository editing and verification rules.

Fork this setup and overfit it to yourself. Keep what fits your work and replace my assumptions with yours.

The repository uses the MIT License. See LICENSE. NOTICE records adapted material.