How coleam00/ai-software-factory works
AI Software Factory installs project-specific context and runtime support, then delegates AI work to Archon’s shared SDLC workflows. The principal loop starts with a human’s release plan, proceeds through issue intake, implementation and independent review, and reaches staging for customer-like validation; defects return as new issues. The repository also supports scheduling and loop health, merge/deployment controls, and isolated runtime verification. Archon’s workflow internals are external to this repository, so those capabilities are represented as an external subsystem and linked where the README documents the relationship.
Main entry points: consumer.py Archon consumer · install.py Project installer · harness Staging use · factory.py Factory CLI
Components 19
Setup and context
- Factory CLI
bin/factory.py - Project installer
bin/install.py - Project context
template
Release workflow
- Archon consumer
template/factory/consumer.py - Archon SDLC pack
- Issue intake
template/factory/consumer.py - Issue implementation
template/factory/consumer.py - Review and merge
template/factory/consumer.py
Validation runtime
- Staging use
template/harness - App harness
template/harness/appproc.py - Revision resource
template/factory/runtime_resource.py - Runtime host
template/factory/runtime_host.py - Process ownership
template/factory/runtime_process.py - Holdout fence
template/.factory/hooks/holdout_fence.py
Loop operations
- Lap scheduler
template/factory/consumer.py - Loop manager
template/factory/consumer.py - Deterministic deployment
template/factory/consumer.py
Other components
- Product planner
- Staging customer
Connections 22
- Product planner → Factory CLI: starts setup
README.md - Factory CLI → Project installer: installs project
bin/factory.py - Project installer → Project context: installs templates
bin/install.py - Project installer → Archon consumer: configures integration
bin/install.py - Project context → Archon SDLC pack: supplies project context
README.md - Product planner → Issue intake: defines release
README.md - Issue intake → Archon SDLC pack: routes workflow
README.md - Archon SDLC pack → Issue implementation: assigns issue
README.md - Issue implementation → Archon SDLC pack: submits work
README.md - Archon SDLC pack → Review and merge: routes review
README.md - Review and merge → Staging use: merges to staging
README.md - Staging customer → Staging use: uses release
README.md - Staging customer → Issue intake: reports defects
README.md - Staging use → App harness: validates app
README.md - Revision resource → Runtime host: provides resource root
template/factory/runtime_resource.py - Runtime host → Process ownership: owns app processes
template/factory/runtime_host.py - Archon consumer → Archon SDLC pack: invokes pinned source
template/factory/consumer.py - Archon consumer → Lap scheduler: launches laps
README.md - Lap scheduler → Archon SDLC pack: starts workflow runs
README.md - Archon consumer → Loop manager: manages loop health
README.md - Archon SDLC pack → Deterministic deployment: routes deployment
README.md - Review and merge → Holdout fence: uses holdout protection
README.md