Skip to content

arslan70/haytham

Repository files navigation

Haytham

License: MIT

AI can build your app in minutes. Haytham builds your product for years.

Lovable, Bolt, and v0 build apps. Haytham builds products: validated, specified, traceable, and evolvable. Run one command inside Claude Code. Get market research, a GO/NO-GO verdict, MVP scope, architecture decisions, an implementation-ready OpenSpec, and a working system. Every requirement traces to a capability. Every capability traces to a validated need.

The Yes-Machine Problem: AI that builds without validating

Install

/plugin marketplace add arslan70/haytham
/plugin install haytham@haytham

No Python. No API keys. No environment variables. Works with your existing Claude Code subscription.

Try it

/haytham "a gym community leaderboard with anonymous handles"

Takes ~20 minutes. You'll be asked for approval at each phase boundary. You can stop, correct, or redirect at any point.

What you get

Four phases, each answering one question. You approve before each phase advances.

Phase 1: Should this be built?
  → Market research, competitor analysis, risk scoring
  → GO / NO-GO / PIVOT verdict backed by evidence
  → If it says NO-GO, it tells you why. That's the point.

Phase 2: What exactly?
  → MVP scope with clear in/out boundaries
  → Capability model with full traceability
  → System traits (auth, payments, real-time, etc.)

Phase 3: How to build it?
  → Build-vs-buy analysis per capability
  → Architecture decisions linked to capabilities
  → Cost and effort estimates

Phase 4: What are the specs?
  → OpenSpec with SHALL requirements
  → Gherkin scenarios for acceptance testing
  → Ready to hand to Claude Code or any coding agent

Every requirement traces to a capability. Every capability traces to a validated need. Every decision traces to the capabilities it serves.

See example output

The examples/ directory contains complete outputs from real Haytham runs across different idea types:

Example Type Verdict
Gym Leaderboard B2C consumer app GO (high risk)
Git Changelog CLI Developer tool GO
Invoice Reconciler B2B SaaS PIVOT

Each example shows the full output tree: validation report, MVP scope, architecture decisions, and OpenSpec.

Output structure

All output lives in .haytham/session/:

.haytham/session/
├── phase-1-why/
│   ├── idea-analysis.md          # Problem analysis, segments, UVP
│   ├── concept-anchor.json       # Invariants that prevent idea drift
│   ├── market-research.md        # TAM/SAM/SOM, trends, risks
│   ├── competitor-research.md    # Who else is doing this
│   ├── research-brief.md         # Neutral summary (no scores)
│   └── validation-report.md      # GO/NO-GO/PIVOT with evidence
├── phase-2-what/
│   ├── mvp-scope.md              # What's in, what's out, core flows
│   ├── capabilities.json         # Functional + non-functional capabilities
│   └── system-traits.json        # Auth, deployment, data layer, etc.
├── phase-3-how/
│   ├── build-buy.json            # BUILD/BUY/HYBRID per capability
│   ├── architecture-decisions.json
│   └── research-directives.json  # What to investigate before coding
└── phase-4-specs/
    └── openspec/
        ├── config.yaml
        ├── project.md
        └── specs/
            ├── domain-name/spec.md
            └── cross-cutting/spec.md

How it works

Ten specialist agents across four phases. Market research agents run web searches. The report synthesizer weighs evidence and produces an honest verdict. If risks are high, it says so. If the idea doesn't hold up, it recommends NO-GO.

Concept anchors (extracted in Phase 1) are passed unchanged to every downstream agent, preventing the "telephone game" where your specific idea gets genericized into something bland.

Read more: How It Works | System Evolution

Commands

Pipeline

Command Description
/haytham "idea" Run all 4 phases end-to-end
/haytham:validate "idea or URL" Phase 1: Market research and GO/PIVOT/NO-GO verdict
/haytham:specify Phase 2: MVP scope and capability model
/haytham:design Phase 3: Build/buy analysis and architecture decisions
/haytham:plan Phase 4: Generate implementation-ready OpenSpec
/haytham:build Set up a new project from Phase 4 specs

Utilities

Command Description
/haytham:demo <URL> Batch-validate a URL and export the report to a demos repo
/haytham:export Export a validation report to a demos repository for sharing

Quality reviews

Command Description
/haytham:ux-review Analyze a run transcript for UX guideline compliance
/haytham:review-fidelity Check if output stays faithful to the original idea
/haytham:review-consistency Check cross-stage consistency and traceability
/haytham:review-depth Check Phase 1 analysis depth and evidence quality
/haytham:review-actionability Check if the spec is detailed enough to implement

Both /haytham:validate and /haytham:demo accept Reddit post and GitHub repo URLs. Use --batch with /haytham:validate to skip interactive gates.

Share your experience

Tried Haytham? We want to hear about it.

Documentation

License

MIT License

About

Validate startup ideas and generate implementation-ready specs. Claude Code plugin.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors