docs(plans): add vision, architecture context, and README requirements to execution guide

- Vision section with full lifecycle and zero-barrier value proposition
- Wave 0 prompt enriched with architectural context (ultraplan as engine,
  pause/resume, MCP phases, marketplace recommendation)
- Session 8 prompt with critical decisions: thin orchestrator architecture,
  ultraplan detection, README value proposition, honest deployment trade-offs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-04-11 10:52:44 +02:00
commit 3202818c28

View file

@ -1,5 +1,28 @@
# Agent Factory — Execution Guide # Agent Factory — Execution Guide
## Vision
Agent Factory gjør det mulig for alle å lage egne agentløsninger som gjør
reelle oppgaver — gjennom en guidet, profesjonell prosess fra ide til produksjon.
**Full lifecycle:** Ide → Design → Build → Test → Deploy → Monitor → Improve
**Zero barrier:** Brukeren installerer ktg-plugin-marketplace og får Agent Factory +
ultra-suiten (ultraplan, ultraresearch, ultraexecute). Ingenting annet trengs —
ingen servere, ingen databaser, ingen konfigurasjon. Bare Claude Code og en plugin.
**Arkitektur:** Pluginens verdi er domenekunnskap (hva som utgjør et godt agent-system).
Ultraplan er motoren (hvordan det bygges profesjonelt). Pluginen er en tynn orkestrator
som kjører et domenespesifikt intervju, mater resultatet til ultraplan, og lar
ultraexecute implementere planen.
**Deployment er et valg:** Lokal (cron/launchd), VPS (systemd), Docker, eller
Managed Agents (begrenset — ingen MCP-støtte). Alle targets med full MCP
er likeverdige. Brukeren velger basert på sine behov.
**Inspirasjon, ikke konkurranse:** OpenClaw og Paperclip er referanseimplementasjoner
vi lærer av. Agent Factory konkurrerer ikke med dem — vi løser et annet problem.
## Overview ## Overview
The ultraplan (`ultraplan-2026-04-11-agent-factory.md`) has 27 steps across 8 sessions The ultraplan (`ultraplan-2026-04-11-agent-factory.md`) has 27 steps across 8 sessions
@ -43,6 +66,13 @@ If not using ultraexecute, use this prompt:
``` ```
Agent Factory Wave 0: Create session blueprints. Agent Factory Wave 0: Create session blueprints.
VISION (read this first — it shapes everything):
Agent Factory gjør det mulig for alle å lage egne agentløsninger som gjør
reelle oppgaver. Full lifecycle: Ide → Design → Build → Test → Deploy → Monitor → Improve.
Zero barrier: bruker installerer ktg-plugin-marketplace, får Agent Factory + ultra-suiten.
Ingenting annet trengs. Pluginen er en tynn orkestrator med domenekunnskap — ultraplan
er motoren. OpenClaw og Paperclip er inspirasjon, ikke konkurrenter.
Context: Context:
- Plan: .claude/plans/ultraplan-2026-04-11-agent-factory.md - Plan: .claude/plans/ultraplan-2026-04-11-agent-factory.md
- Spec: .claude/ultraplan-spec-2026-04-11-agent-factory.md - Spec: .claude/ultraplan-spec-2026-04-11-agent-factory.md
@ -79,6 +109,20 @@ For exact template content, use:
- Source code analysis for implementation details (heartbeat format, budget schema, etc.) - Source code analysis for implementation details (heartbeat format, budget schema, etc.)
- Existing codebase files for conventions (frontmatter format, placeholder syntax, hook patterns) - Existing codebase files for conventions (frontmatter format, placeholder syntax, hook patterns)
ARCHITECTURAL CONTEXT for blueprints:
- Build command (Session 8) should be a thin orchestrator: run domain-specific
interview → produce spec → feed to ultraplan → ultraexecute implements.
Standalone mode as fallback when ultraplan is not installed.
- Build command includes pause/resume mechanism (build-state.json) for when
users need to create MCP servers or skills between phases.
- Phase 3.5: Skills connection (existing or custom, with pause/resume)
- Phase 4.5: MCP server integration (connect existing, guide creation, pause/resume)
- Deployment targets: cron/launchd, systemd, Docker (full MCP support).
Managed Agents as limited option (no MCP — only simple agents).
- README must prominently recommend ktg-plugin-marketplace installation.
- README value proposition: "Install one plugin, build complete agent systems
that do real work. No servers, no databases, no configuration."
All bash scripts must be bash 3.2 compatible. All templates use {{PLACEHOLDER}} syntax. All bash scripts must be bash 3.2 compatible. All templates use {{PLACEHOLDER}} syntax.
Python3 for JSON/YAML/date parsing in scripts. Python3 for JSON/YAML/date parsing in scripts.
@ -308,6 +352,23 @@ Execute steps 8, 26, 27:
- Resume mechanism: --resume flag reads build-state.json - Resume mechanism: --resume flag reads build-state.json
27. Update plugin.json to v1.0.0, rewrite CLAUDE.md and README.md for full Agent Factory 27. Update plugin.json to v1.0.0, rewrite CLAUDE.md and README.md for full Agent Factory
CRITICAL ARCHITECTURAL DECISIONS for Step 26 (build command):
- Build command should be a THIN ORCHESTRATOR: run domain-specific interview,
produce spec, feed to ultraplan-local if available, fall back to standalone if not.
- Detect ultraplan availability: check if /ultraplan-local skill exists.
If yes: offer "Professional mode (recommended): uses ultraplan for deep planning"
If no: run standalone build workflow (current monolithic approach)
- Build must support pause/resume: build-state.json persists all state between sessions
CRITICAL for Step 27 (README):
- README must prominently recommend ktg-plugin-marketplace:
"## Prerequisites\n\nInstall the plugin marketplace for the full experience:\n\n```\n/install ktg-plugin-marketplace\n```\n\nThis gives you Agent Factory + the ultra-suite (ultraplan, ultraresearch,\nultraexecute) for professional-grade agent system development."
- Value proposition: "Install one plugin, build complete agent systems that do
real work. Full lifecycle from idea to production. No servers, no databases,
no configuration — just Claude Code."
- Deployment targets section with honest trade-offs (Managed Agents = limited, no MCP)
- Credit OpenClaw + Paperclip as inspiration, not competitors
Steps 8 and 26 both modify commands/build.md — execute them SEQUENTIALLY. Steps 8 and 26 both modify commands/build.md — execute them SEQUENTIALLY.
Step 27 is the final commit: "feat: Agent Factory v1.0.0" Step 27 is the final commit: "feat: Agent Factory v1.0.0"