Turn methodology
into executable agents.
Airic is an open-source methodology runtime that converts playbooks, SOPs, expert workflows, and team practices into document-defined agent packs. Agents run the method, reflect on the work, and propose improvements as human-reviewable Markdown diffs.
.airic/ ├─ packs/ │ ├─ packsmith/ │ └─ founder-demo/ └─ specs/ ├─ roles/ ├─ document-types/ ├─ processes/ └─ precedents/
Agents are powerful. Methods are still trapped in documents.
Modern agents can code, research, browse, and automate. But serious work still depends on methodology: how to frame problems, make decisions, review results, avoid failure modes, and improve over time.
Today, that knowledge is scattered across books, PDFs, Notion pages, consulting decks, SOPs, and expert memory. Skill systems can package procedures, but a real methodology is more than one skill.
// roles · artifacts · processes · review standards · judgment · learning loops
Airic makes methodology executable.
Document-defined agents
Agent behavior lives in editable Markdown, not hidden prompts.
specs/roles/reviewer.mdExtension packs
Package a methodology as roles, document types, processes, precedents, and tool policies.
packs/<your-method>/Packsmith
Convert a playbook, SOP, course, or expert workflow into an Airic extension pack.
airic pack from ./sourceExecutable documents
Turn clarified intent into task documents agents can act on.
task.md → run()Visible reflection
Agents review their own work and surface friction, failure patterns, and missing rules.
reflect --run lastHuman-approved learning
Improvements become reviewable Markdown diffs before changing future agent behavior.
+ added precedent #014Packsmith: build packs from methods.
Packsmith is the first Airic extension. It helps you extract a methodology from source material and turn it into a runnable Airic pack.
- ▸startup playbooks
- ▸engineering workflows
- ▸company SOPs
- ▸consulting frameworks
- ▸course materials
- ▸expert interviews
- ▸existing skill repos
my-method-pack/ ├─ README.md ├─ roles/ ├─ document-types/ ├─ processes/ ├─ precedents/ ├─ tool-policies/ └─ examples/
Founder Playbook → Founder Pack
Airic uses Packsmith to convert an AI-native startup playbook into a Founder Demo Pack. This demo proves the core loop: a methodology can be extracted, executed, reviewed, and improved.
- 01idea validation
- 02problem hypothesis
- 03customer discoveryin progress
- 04MVP scope
- 05launch readiness
- 06GTM planning
- 07reflection and improvement
Self-improvement you can inspect.
Airic does not silently update hidden memory. After work is done, Airic reflects on the process — and proposes changes as Markdown diffs you review and approve.
- ?What went wrong?
- ?Which context caused the mistake?
- ?Was the process unclear?
- ?Was the document type missing a requirement?
- ?Should this human judgment become a precedent?
- ?Should the pack be improved?
Airic learns by editing methodology documents —
with human approval.
@@ -12,6 +12,11 @@
When framing a customer problem,
always restate it as a Job-To-Be-Done
before generating solution candidates.
+ ## Precedent (added 2026-06-27)+ If the user describes a workflow,+ extract the trigger, the desired+ outcome, and the current workaround+ before proposing any solution.- // TODO: revisit framing rules
Not another black-box agent.
AiricBuilt for hackers, researchers, and method builders.
Airic is open-source and workspace-native. It works with ordinary files, Markdown specs, and git-friendly workflows — designed for people who want to understand, modify, and extend how their agents behave.