@dzhng: Love this framing. A software factory shouldn't require the human to review every line of code, but every *decision* sh…
Summary
The developer dzhng shares a GitHub repository of composable AI agent skills for building software factories, enabling autonomous goal-driven code generation with human review at decision points.
View Cached Full Text
Cached at: 07/20/26, 09:49 AM
Love this framing. A software factory shouldn’t require the human to review every line of code, but every decision should be backed by a human review. AI is the perfect execution machine but still imperfect decision makers. Added to my skill repo: https://github.com/dzhng/skills
dzhng/skills
Source: https://github.com/dzhng/skills
Skills

AI skills for building software factories. My personal library of domain-agnostic agent skills, reused across every project. Small, composable, and hackable — works with any harness that supports skills: Claude Code, Codex, opencode, Cursor, duet, and 70+ others.
npx skills add dzhng/skills
Add --list to pick individual skills, or copy any skills/<category>/<name>/
folder into your harness’s skills directory (e.g. .claude/skills/).
Why
Software is moving from tasks to factories: agents that pursue a goal autonomously until the output can be trusted. The hard part isn’t breaking the goal into tasks — it’s breaking it into independently verifiable pieces, and knowing where the pieces even are.
These skills run that loop. Treat the unknown as fog of war: map the terrain, carve it into territories that build and verify in isolation, and recursively re-slice whatever hides more map. And re-planning doesn’t stop when planning ends — the spec is a living document, updated and re-sliced mid-implementation whenever the work teaches the agent that the plan is stale. Every piece must prove itself — architecture review, code review, and visual review against a baseline — before the loop moves on. Each iteration gets less wrong, until the goal is done.

Proof: one unattended Codex run pursuing a single goal for 1d 16h on top of these skills, slicing and iterating until done.
How to use
-
Plan. Ask your agent to
/write-specthe goal. It interviews you, researches the unknowns, and materializes a spec underspecs/<feature>/— a slice graph where every slice is independently verifiable. -
Build. Kick off the loop:
/goal /implement-spec specs/<feature>Add whatever framing fits:
on the xyz branch, orusing /codex as the implementer while you stay the parent orchestrator and reviewer. -
The rest fires on its own. The spec tells the loop when to call the other skills — a
/reviewpass at the end of every slice,/screenshot-critiqueand/compare-screenshotson anything visual,/close-specwhen the last slice lands — and to update and re-slice the plan whenever implementation proves it stale. Every skill is also independently useful: invoke any of them manually whenever you want.
Skills
Engineering — slice, build, verify, repeat
| Skill | What it does |
|---|---|
| explore-unknowns | Walk the user through mapping a task’s unknowns quadrant by quadrant — known knowns first, then interviews, reactable artifacts, and blindspot passes — ending with a complete four-quadrant map. |
| write-spec | Break a large feature into independently verifiable, human-reviewable slices with API seams and playable checkpoints. |
| implement-spec | Build an existing spec to completion, one reviewable pass at a time, delegating independent slices in parallel. |
| implement-spec-with-codex | Run implement-spec with Codex writing the code — you orchestrate, integrate, and review every pass. |
| close-spec | Archive a shipped spec and rewrite it from a build plan into a durable rationale record that points back at the code. |
| refactor-clean | Refactor by moving ownership to one clean concept instead of layering compatibility sediment beside the problem. |
| write-tests | Write tests one tracer bullet at a time that pin real behavior — not implementation details, config values, or lucky samples. |
| write-docs | Write docs as a glossary of principles and pointers, never a mirror of the code that will rot. |
| code-review | Audit a diff for stale names, dead references, needless complexity, and comments that narrate instead of explain — ending on a clean/not-clean verdict. |
| audit-choices | Audit the choices an implementer made, not its diff — a pure, never-blocking audit whose ledger discloses the architecture and decisions made on the user’s behalf, reviewed instead of the code. |
| review | Closeout a finished change as one pass — refactor-clean, then code-review, then write-docs — sequenced into a single verdict. |
| codex | Use the local Codex CLI as an independent second agent for review and (on explicit ask) delegated implementation. |
| claude | Use Claude Code (claude -p) as an independent second agent for consultation and (on explicit ask) delegated implementation. |
Visual review — never accept visuals on vibes
| Skill | What it does |
|---|---|
| compare-screenshots | Judge which image is less wrong against a target you establish — telemetry to locate divergence, not a baseline match. Ships a reusable diff script. |
| screenshot-critique | Use an unprimed subagent as a second set of eyes on visual work before accepting it; mandatory before declaring a reported visual bug fixed. |
| preview-shots | Open a curated set of image shots in one macOS Preview window for the user to eyeball. |
Authoring — keep the skills themselves sharp
| Skill | What it does |
|---|---|
| write-skills | Create or revise agent skills: triggers, leading words, progressive disclosure, and the failure modes to prune. |
| eval-skills | Eval a skill against golden cases — blind runs in fresh subagents, a separate judge, and gap-driven edits. |
Graphics
| Skill | What it does |
|---|---|
| renderer | Build, debug, or review WebGPU renderer work — three.js/TSL scene layers, node materials, WGSL passes, depth semantics, and browser-verified visuals. |
License
MIT
Taelin (@VictorTaelin): I think I finally figured out how to use AI at scale
of course, the fact Fable is good is part of it. but I also changed how I work, and it all comes down to one key realization: you don’t need to audit the code, but you NEED to audit the choices it made. if you just do that,
Similar Articles
@hnshah: https://x.com/hnshah/status/2066761276945211442
Hiten Shah reflects on how AI is transforming GitHub from a repository of evidence into an environment where non-coders can apply product judgment directly to software workflows, bridging the gap between customer understanding and code.
@zachlloydtweets: https://x.com/zachlloydtweets/status/2077428025474355521
This post describes how to build a self-improving code review agent as part of a cloud software factory, using a code review skill, GitHub actions, and an outer-loop agent for continuous improvement.
@dzhng: Fed this article to Fable and we created an explore-unknowns skill It scans your codebase, then interviews you one ques…
A personal library of composable AI skills for building software factories, including an explore-unknowns skill that scans codebases and interviews developers to close known and unknown unknowns.
@dzhng: Hot tip: use Fable-5 for planning and as the general orchestrator and reviewer, and Codex as the actual implementer so …
Tip to use Fable-5 as orchestrator and Codex as implementer to save credits, with a link to a library of composable AI agent skills for autonomous software development.
@addyosmani: https://x.com/addyosmani/status/2079442194449232227
This essay by Addy Osmani explores the concept of software factories as scaled agent loops, distinguishing between light factories with human oversight and dark factories without, and emphasizes the importance of understanding and designing the loop, harness, and factory structures.