Skip to content

axumquant/axum-method

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

axum-method

A proof-driven, AI-accelerated method for taking infrastructure from idea to production

Status AI License Templates

Principles · Idea → Production · How I use AI · Evidence · Templates


The thesis: infrastructure that makes operations effortless is infrastructure that proves itself, fails closed, self-heals, and degrades gracefully. This repo is how I build it — and how I use AI to build it fast without losing rigor.

Most "engineering process" write-ups are aspirational. This one isn't. Every principle and template here was extracted from three production systems I designed and shipped end-to-end, then generalized so any engineer can drop it into any project:

  • an autonomous quantitative trading platform (Rust + Python, evolutionary strategy discovery, a 9-stage statistical validation gauntlet),
  • a real-time AI sales-coaching platform handling regulated health data (sub-second multi-agent cues, HIPAA-aligned, self-healing portal integration), and
  • an autonomous AI web agency (an agent swarm that takes a brief to a deployed, monitored site).

Three very different domains. The same spine held all three up — that spine is this repo.


The method at a glance

Idea to production in seven stages, each with a gate that has to pass before the next begins:

flowchart LR
  F[1 · Frame] --> S[2 · Spike] --> C[3 · Contract] --> B[4 · Build] --> P[5 · Prove] --> SH[6 · Ship] --> W[7 · Watch]
  W -.lessons.-> F
Loading
Stage What happens The gate
1 · Frame Turn a vague ask into scope + explicit verification gates + halt conditions Can I state exactly what "done" looks like and how I'll prove it?
2 · Spike Cheapest experiment that kills the riskiest assumption first Is the scariest unknown now known?
3 · Contract Typed schemas at every boundary; an RFC for anything with a migration Are the interfaces typed and the change reversible?
4 · Build AI in the loop, config-as-data, fail-closed defaults, separation of powers Does it fail closed and degrade gracefully?
5 · Prove Every claim ships with its evidence artifact; thresholds calibrated, not guessed Is there a proof artifact for every assertion?
6 · Ship Reversible migrations, parallel-session safety, guardrail hooks Can I roll this back in one step?
7 · Watch First-party telemetry + self-healing; distill lessons back into memory Does it tell me when it breaks — and fix what it can itself?

Full walkthrough: docs/IDEA-TO-PRODUCTION.md.


The principles

Fourteen named principles form the spine. A few headliners:

  • Prove it, don't assert it — no claim about system state ("tests pass", "deployed", "healthy") ships without the specific evidence artifact, quoted inline.
  • Liveness ≠ health — "the process is running" never proves a service works; require a functional probe and clean behavioral logs.
  • Fail closed — every gate, consent check, and agent defaults to refuse on ambiguity; no single actor holds end-to-end authority.
  • Degrade, don't die — when a dependency dies, shift weight to the deterministic path; never wedge the system.
  • Calibrate, don't guess — never change a threshold by intuition; simulate three variations against real data and pick with a table.

All fourteen, each with why, how, and which project proved it: PRINCIPLES.md.


How I use AI

I architect with AI in the loop and validate everything it produces — the discipline is what makes it fast and trustworthy. The verify-everything loop, the /go vs /goal operating modes, autonomous-loop hardening, and memory hygiene: docs/AI-WORKFLOW.md.


Use it on your project

The templates/ directory is a drop-in kit (built for Claude Code, adaptable to any agent):

Path What it gives you
templates/CLAUDE.md A project-instruction file encoding the proof standard, output discipline, and code boundaries
templates/AGENTS.md An "agent constitution" + /go vs /goal operating modes + a progress ledger
templates/rules/ Path-triggered rules: proof gates, three-variation audit, three-tier health, fail-closed, reversible migrations…
templates/skills/ Invokable skills: claim-with-proof, three-variation audit, goal-hardening
templates/commands/ Slash commands: /verify, /full-system-audit
templates/agents/ Subagent roles with bounded authority (debug, db)
templates/hooks/ Guardrail hooks that mechanize the discipline — destructive-command blocker, no-manual-work guard, clean-only auto-push

Quick start: copy templates/CLAUDE.md to your repo root, copy the templates/rules|skills|commands|agents you want into a .claude/ directory, wire the hooks in .claude/settings.json, and adapt the placeholders.


Proven in production

System Domain The concept it contributed to this method
Trading platform Autonomous quant trading The "$100K Standard" proof gate · three-variation threshold audit · agent separation-of-powers · fault-isolated compute
Sales Coach Real-time AI, regulated (PHI) Hot-path determinism + latency budgets · self-healing integration · deny-by-default consent · defense-in-depth isolation
Studio Autonomous AI web agency Tiered readiness proof-bundle · gateway/anti-corruption abstraction · typed agent handoffs · reversible-migration RFCs

Details (sanitized): docs/CASE-STUDIES.md.


License

MIT — use the templates freely. Authored by Norman Beckford · Axum Labs.

This repository contains only generalized methodology and templates. It includes no proprietary source, secrets, or client/customer data from the systems referenced above.

About

A proof-driven, AI-accelerated method for taking infrastructure from idea to production — distilled from 3 production systems into drop-in templates (CLAUDE.md, rules, skills, commands, agents, hooks) for any project.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors