Software Factory

A reusable Markdown-first operating system for agent-assisted software delivery.

This repo contains templates, prompts, examples, and lightweight checks for turning product docs into a repo-specific program.md that can drive a disciplined coding factory.

The goal is not to ask an agent to build the whole product. The goal is to give an agent enough structure to work one scoped issue at a time, through branch, PR, review, validation, merge, cleanup, retro, and backlog refinement.

Contents

templates/
program-template.md
issue-template.md
pr-template.md
adr-template.md
review-checklist.md
prompts/
customize-program.md
validate-docs.md
generate-backlog.md
review-program.md
checks/
program-lint-rules.md
pr-compliance-checklist.md
examples/
kalshi-program-notes.md
docs/
adoption-guide.md

Intended workflow

PRD + architecture docs
-> validate docs
-> customize program-template.md into repo program.md
-> generate initial user-journey backlog
-> implement one issue at a time
-> PR review and validation
-> merge, cleanup, retro
-> refine backlog

Minimal use

Copy templates/program-template.md into a target repo and ask an agent to fill it using prompts/customize-program.md.

Then use:

• templates/issue-template.md for GitHub issues,
• templates/pr-template.md for pull requests,
• templates/adr-template.md for durable decisions,
• checks/pr-compliance-checklist.md before merge.

Design principles

Product docs are the source of truth. The program is the delivery operating system. Issues are the workbench. PRs are the inspection bay. Tests are the gauges. Retros improve the factory.

Move fast while discovering. Move carefully near irreversible consequences.