From concept
to deployed software.

You provide the concept and a git repository once. The pipeline runs end to end — every specialist, every stage — until the audit is done and the code is pushed live.

SYS · solution-creator
VER · 0.2
BASE · ICM methodology
AGENTS · 07
GATES · 02
01

What this is

meta-system · concept to production

Solution Creator is not a coding assistant. It is a structured pipeline where specialized sub-systems handle each phase of a build — concept, process, architecture, design, visual design, construction, audit, and deployment — in sequence. You provide the concept and the git repository at the start. Everything else runs. You return at the audit.

Every software solution requires the same three things to exist. Solution Creator connects them into a single coordinated pipeline, with a meta-orchestrator above all three.

01

Process clarity

A clear understanding of the real-world workflow being automated — what the software actually does and why.

02

Agent architecture

An intelligent agent layer that supports the process — specialists, boundaries, handoffs, and shared memory.

03

Working software

Deployed, live code that implements the process and the agent layer — audited before it goes live.

02

The pipeline

two human moments · everything else runs

You provide the concept and the git repository once, at the start. From there, the pipeline runs end to end without asking — every specialist, every stage — until the audit report is ready. You read it. If it passes, the code is pushed to your repository and the software goes live.

You provide — once, at the start
Concept
One line describing what you want to build.
The Concept Developer runs a structured two-batch interview to develop this into a full brief covering goals, users, outcomes, and design ethos.
Git repo
The repository where the built code will be pushed.
This is the only infrastructure you set up before the pipeline starts.
Automated · runs end to end without asking
Concept Developer
Process Codifier
ICM Builder
Designer
Visual Designer
Software Creator — plan
Software Creator — build
Every concept brief, process map, architecture spec, design spec, visual token system, and line of code is produced in sequence. Agents hand off between each other directly. Nothing pauses for review.
Audit · the only pause

Audit Agent verifies every module in the build against the architecture spec. Flags missing pieces, rule violations, and anything that would fail in production. You read the report. It is the single decision point before deployment.

→ audit_report.md
Code pushed to git

Everything built goes to the repository you provided at the start. Clean, complete, ready to deploy.

→ git push
Env vars in Coolify

Coolify reads from your repository automatically. You add the environment variables once — database connection, API keys, domain. The software goes live.

→ live URL
03

The specialists

seven agents · one meta-orchestrator

Each sub-system owns a defined phase of the pipeline. The meta-orchestrator coordinates between them — it routes, it never processes. Specialists run as subagents with clean contexts between gates.

Concept Developer

Stage 2 — Concept
pop-green

Runs a structured two-batch interview: first establishes essence (goals, users, outcomes), second captures texture (design ethos, tone, principles). Then researches competitors and the domain's visual conventions before producing the brief all downstream stages build from.

→ concept_brief.md

Process Codifier

Stage 3 — Process
pop-yellow

Extracts and maps the real-world workflow behind the concept. Identifies stages, players, friction points, and the boundary between procedural work and decisions that require human judgment. The map is the foundation for the ICM architecture.

→ process_map.md

ICM Builder

Stage 4 — Architecture
pop-blue

Designs the multi-agent AI layer using Interpretable Context Methodology. Defines specialists and their boundaries, shared infrastructure (catalog, config, database, SOPs), master record schema, and the handoff data contracts between every specialist in the chain.

→ icm_spec/  (identity · rules · examples · handoff per agent)

Designer

Stage 5 — Design
ink

Translates the ICM architecture into a UI/UX specification. Defines views, user flows, role-based access, and interaction patterns before the software architecture is locked. This is a pre-architecture concern, not a build-time one.

→ design_spec.md

Visual Designer

Stage 6 — Visual Design
orange

Commits to one named visual direction — not a mood board, a decision. Derives a complete token system: color palette, type scale, spacing, shape, depth, motion. Produces a project-specific banned list to prevent generic AI defaults from appearing in the build.

→ visual_spec.md  (direction · tokens · banned list)

Software Creator

Stages 7 · 9 · 11 — Build Plan, Build, Deploy
ink

Operates in two shells. The outer shell architects the system before any code is written. The inner shell builds every module and route against the approved architecture spec and deployment config. Deploys directly to live — never localhost.

→ architecture_spec.md → src/ → live URL

Audit Agent

Stage 10 — Audit
pop-red

Runs after the inner shell builds and before any deployment. Checks the build against the architecture spec — missing modules, rule violations, deployment config completeness. Flags gaps before they reach production. No stake in the build it reviews.

→ audit_report.md
04

Two moments of your time

start · audit · done

The pipeline is designed to minimize the human time required. You are not a task manager here — you are a decision maker at two specific moments. Everything between those moments runs without you.

01

The start — concept and git repo

You describe what you want to build in one line. The Concept Developer interviews you in two structured batches to develop that into a complete brief covering goals, users, outcomes, and design ethos. You also provide the git repository URL where the built code will be pushed. That is the entirety of your setup work.

02

The end — reading the audit report

After the full pipeline has run — concept development, process mapping, architecture, design, visual design, build plan, and build — the Audit Agent verifies every module against the spec and produces a report. You read it. If the build passes, the code is pushed to your git repository and you set the environment variables in Coolify. The software is live.

Everything between those two moments — every spec, every decision, every line of code — runs without asking. That is the point.

05

The thinking behind it

design decisions · why they were made

No localhost — ever

All builds target live deployment environments from the first file written. The deployment config must exist before any code starts. Local environments diverge from production. Testing locally gives false confidence. The cost of setting up real infrastructure once is lower than the cost of debugging environment-specific failures later.

Deployment config before code

The deployment_config.md — repo URL, VPS app names, database connection, environment variables, domain — must be complete and confirmed before the inner shell writes a single line. Code written for the wrong environment is not deployable code. Configuration is not a detail; it is the foundation.

Everything tracked in three files

Every session, every agent, every decision is logged to project_record.md (phase and gates), dev_record.md (append-only build history), and connection_map.json (live topology). Without a persistent, machine-readable record, every session starts from zero. The record is the continuity.

Sub-systems stay intact

Process Codifier, ICM Builder, and Software Creator are not merged or flattened. They live as independent sub-systems with their own methodologies and evolve independently. The meta-orchestrator handles coordination; sub-systems handle execution.

Concept Developer at the front

Every downstream stage was inheriting a one-line concept and guessing the rest. The guesses compounded. A researched, gated brief at the front means Process Codifier extracts the right workflow, ICM Builder optimizes for the right goals, and Visual Designer designs from a stated ethos instead of inventing one.

Visual Designer as a gated stage

When no agent owns aesthetics, the build defaults to the generic AI look — rounded cards, soft shadows, Inter, indigo. The Visual Designer makes the visual direction a gated, reviewable decision. The banned list it produces binds the Software Creator's UI work. Without this stage, nobody decides the look.

Audit before every deploy

Inner shell agents build sequentially. Errors compound. A dedicated audit pass before deployment catches systemic gaps — missing modules, rule violations, config inconsistencies — before they reach production. The audit agent has no stake in the build it reviews.

06

What a project produces

one folder · everything in it

Every project lives in _projects/{project-name}/ — the complete record of what was built, why, and how to change it.

PROJECT RECORD _projects/{project-name}/
_projects/{project-name}/
project_record.md ← master state: phase, gates cleared, live URL, blockers
dev_record.md ← append-only build log: what, who, when, decisions
connection_map.json ← live topology: modules, edges, health
concept_brief.md ← goals, users, design ethos, market research
process_map.md ← real-world workflow: stages, players, friction
icm_spec/ ← multi-agent architecture: all specialist folders
design_spec.md ← views, user flows, role access
visual_spec.md ← visual direction, full token system, banned list
architecture_spec.md ← modules, schema, event bus, deployment topology
deployment_config.md ← repo, VPS apps, database, env vars, domain
audit_report.md ← build verification against spec
src/ ← the built software
07

What this is not

scope boundaries
Not a general-purpose coding assistant. It does not answer one-off questions or write isolated scripts. Every build goes through the full pipeline.
Not a project management tool. There are no tickets, no sprints, no assignees. There are stages, gates, and outputs.
Not a local development environment. It has no localhost. The first deployment is the only deployment target.
Not a design tool producing visual mockups. The Visual Designer produces a token system and a direction — not wireframes or Figma files.
Not a replacement for human judgment at gates. The pipeline pauses at every gate. Agents execute; humans approve the direction.
08

Built with this

athletic-os · concept to code

Athletic OS is the first project built end-to-end through Solution Creator. A single-user, self-hosted training instrument — lifts, bouldering, runs, weight — with a closed-loop weekly AI coaching cycle. Below is how it appears in the Solution Creator dashboard.

athletic-os source: factory has_src · has_icm_spec BUILD COMPLETE
concept process architecture design visual_design build_plan build audit → deploy
concept_brief.md process_map.md design_spec.md visual_spec.md architecture_spec.md deployment_config.md src/ (backend · ai_layer · migrations)
React 18 + Vite PWA · FastAPI · SQLite · Claude API · Coolify on VPS.
3 AI agents (Weekly Coach · Case Advisor · Log Parser) · 8 route modules · 9 data models.
Visual direction: Telemetría de pista — dark cockpit, Barlow Condensed, amber-only accent, six Motion Boulder grade colors reserved exclusively for grade encoding.
View project →