Skip to content

Commit 84d393e

Browse files
jwaldripclaude
andcommitted
feat: establish HAIKU foundation - manifesto, brand identity, repo structure
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent acc5ee9 commit 84d393e

File tree

4 files changed

+195
-424
lines changed

4 files changed

+195
-424
lines changed

HAIKU.md

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
# HAIKU: Human AI Knowledge Unification
2+
3+
**A universal framework for structured human-AI collaboration across any domain.**
4+
5+
HAIKU provides a disciplined, phase-driven methodology that governs how humans and AI systems collaborate to move from intent to outcome. Like the poetic form it draws its name from, HAIKU achieves clarity through constraint --- structured form that channels creative energy into reliable, repeatable results.
6+
7+
**Domain:** [haikumethod.ai](https://haikumethod.ai)
8+
9+
---
10+
11+
## The 4-Phase Lifecycle
12+
13+
Every initiative in HAIKU follows four phases. Each phase has a distinct purpose and produces artifacts that feed the next.
14+
15+
### 1. Elaboration
16+
17+
**Purpose:** Define what will be done and why.
18+
19+
Elaboration transforms a broad intent into a structured plan. This phase produces the shared understanding that all subsequent work depends on.
20+
21+
- **Define intent** --- articulate the goal, scope, and desired outcome
22+
- **Decompose into units** --- break the intent into discrete, addressable pieces of work
23+
- **Set success criteria** --- establish measurable conditions that define completion
24+
- **Build domain model** --- capture the vocabulary, constraints, and relationships of the problem space
25+
26+
Elaboration is complete when every unit has clear success criteria and the decomposition covers the full intent.
27+
28+
### 2. Execution
29+
30+
**Purpose:** Do the work.
31+
32+
Execution operates through hat-based workflows: ordered sequences of behavioral roles (hats) that structure how work progresses. Each unit moves through its workflow in iterative cycles called bolts.
33+
34+
- **Hats** define behavioral roles (e.g., planner, executor, reviewer)
35+
- **Workflows** define the ordered sequence of hats a unit passes through
36+
- **Bolts** are iteration cycles within a unit --- each bolt advances the work and produces a reviewable increment
37+
- **Quality gates** provide configurable backpressure, ensuring work meets standards before progressing
38+
39+
Execution is complete when all units satisfy their success criteria and pass their quality gates.
40+
41+
### 3. Operation
42+
43+
**Purpose:** Manage what was built.
44+
45+
Operation governs the ongoing management of delivered outcomes. Not every intent ends at delivery --- many require sustained activity.
46+
47+
- **Recurring tasks** --- scheduled, repeatable activities with AI assistance
48+
- **Reactive responses** --- triggered actions in response to events or conditions
49+
- **Manual activities with AI guidance** --- human-led work supported by AI recommendations and context
50+
51+
Operation continues for as long as the delivered outcome requires active management.
52+
53+
### 4. Reflection
54+
55+
**Purpose:** Learn from what happened.
56+
57+
Reflection closes the loop. It analyzes outcomes against original intent, captures learnings, and feeds insights forward into organizational memory and future elaboration cycles.
58+
59+
- **Analyze outcomes** --- compare results to success criteria and original intent
60+
- **Capture learnings** --- document what worked, what failed, and why
61+
- **Feed forward** --- update organizational memory, refine processes, and inform the next iteration
62+
63+
Reflection transforms experience into institutional knowledge.
64+
65+
---
66+
67+
## Core Principles
68+
69+
### Disciplined Structure
70+
71+
Like haiku poetry, constrained form produces clarity. HAIKU imposes structure not to limit creativity but to channel it. Every phase, hat, workflow, and quality gate exists to reduce ambiguity and increase the signal-to-noise ratio of collaborative work.
72+
73+
### Iterative Refinement
74+
75+
Work progresses through bolts within units within intents. Each iteration produces a reviewable increment. Small cycles with frequent feedback prevent drift and compound learning.
76+
77+
### Domain-Agnostic Design
78+
79+
HAIKU is not bound to any single industry or discipline. The same lifecycle --- elaboration, execution, operation, reflection --- applies to software engineering, marketing campaigns, strategic planning, operations management, and scientific research. Domain specifics are handled by profiles (see below).
80+
81+
### Learning Loops
82+
83+
Reflection is not optional. Every completed intent feeds learnings back into organizational memory. Future elaboration draws on past reflection. This creates a compounding advantage: teams that use HAIKU get better at using HAIKU.
84+
85+
### Human-AI Collaboration Modes
86+
87+
HAIKU recognizes three modes of collaboration, configurable per unit or per phase:
88+
89+
| Mode | Description |
90+
|------|-------------|
91+
| **Supervised** | Human directs, AI assists. Human approves every significant action. |
92+
| **Observed** | AI executes, human monitors. Human intervenes when needed. |
93+
| **Autonomous** | AI executes independently within defined boundaries. Human reviews outcomes. |
94+
95+
The appropriate mode depends on risk, complexity, and organizational trust. HAIKU supports fluid movement between modes as context changes.
96+
97+
---
98+
99+
## The Profile Model
100+
101+
HAIKU defines the universal methodology. **Profiles** adapt it to specific domains.
102+
103+
A profile customizes HAIKU for a particular field by defining domain-specific hats, workflows, quality gates, tooling integrations, and artifact types --- while preserving the core 4-phase lifecycle and principles.
104+
105+
| Profile | Domain | Key Customizations |
106+
|---------|--------|--------------------|
107+
| **AI-DLC** | Software Development | Git integration, test suites, PR workflows, CI/CD pipelines, deployment gates |
108+
| **SWARM** | Marketing & Sales | Scope, Workstreams, Accountability, Results, Memory --- campaign planning, content workflows, performance analysis |
109+
| *Custom* | Any Domain | Organizations define their own profiles for operations, research, strategy, etc. |
110+
111+
**AI-DLC** is the software development profile of HAIKU. It was the first profile developed and serves as the reference implementation.
112+
113+
**SWARM** (Scope, Workstreams, Accountability, Results, Memory) validates HAIKU's universality by demonstrating the framework's applicability beyond software, in the domain of marketing and sales.
114+
115+
Organizations can create custom profiles for any domain while inheriting HAIKU's lifecycle, principles, and collaboration model.
116+
117+
---
118+
119+
## Terminology
120+
121+
| Term | Definition |
122+
|------|------------|
123+
| **Intent** | The thing being accomplished --- the top-level goal or initiative |
124+
| **Unit** | A discrete piece of work within an intent |
125+
| **Bolt** | An iteration cycle within a unit --- each bolt advances and produces a reviewable increment |
126+
| **Hat** | A behavioral role assumed during execution (e.g., planner, builder, reviewer) |
127+
| **Workflow** | An ordered sequence of hats that defines how a unit progresses |
128+
| **Quality Gate** | A configurable verification checkpoint that provides backpressure |
129+
| **Phase** | A stage in the lifecycle: Elaboration, Execution, Operation, or Reflection |
130+
| **Profile** | A domain-specific implementation of HAIKU (e.g., AI-DLC for software, SWARM for marketing) |
131+
| **Collaboration Mode** | The human-AI interaction pattern: Supervised, Observed, or Autonomous |
132+
133+
---
134+
135+
## Why "HAIKU"
136+
137+
The name carries intention at every level.
138+
139+
**The acronym** --- Human AI Knowledge Unification --- captures the framework's purpose: unifying human judgment and AI capability into a coherent, structured collaboration.
140+
141+
**The poetic form** --- haiku is a Japanese poetic tradition defined by rigid structural constraints (5-7-5 syllables) that paradoxically produce profound clarity and beauty. HAIKU the methodology works the same way: disciplined structure that produces clear, effective outcomes.
142+
143+
**The cultural resonance** --- rooted in the same tradition as bushido, haiku reflects disciplined mastery and the pursuit of excellence through practice and form. The Bushido Collective builds on this heritage: the unification of human creativity and AI capability through deliberate, principled structure.

0 commit comments

Comments
 (0)