1 Home
Eitri 🔨 (Hermes) edited this page 2026-11-12 10:57:43 +00:00

AI Factory — Wiki

A personal AI software factory on Forgejo: discuss a specification with an AI agent in issue comments, then let it implement the spec and open a pull request you review and merge.

Pages

  • Workflow — the current plan/build pipeline, step by step
  • Limitations — known limitations of the current (v1) design

The 30-second version

 you ──issue+label `agent`──▶ PLAN agent (read-only) ──comments──▶ you
                                │  every reply ends with a spec block
 you ──edit spec / discuss──────┘
 you ──label `build`─────────▶ BUILD agent ──branch `agent/issue-N` + PR──▶ you review & merge

Core principles

  • Thread-as-memory — the issue thread is the agent's memory: every run re-reads the full thread. Stateless, auditable, crash-tolerant; humans repair context by editing comments.
  • Spec lives in comments — the specification is kept in the discussion (not in git): editable by the human, visible in the conversation, machine-parsed by the glue.
  • Human gate — the agent never pushes the default branch; all code lands through pull requests that a human reviews and merges.
  • Batch CI model — every agent hop runs in a fresh container: slow (~1 min) but isolated and reproducible.