@hasankhatib/create-ai-scaffold
v0.3.1
Published
Initialize structured AI collaboration in any repo — agent-agnostic dispatch, council deliberation, session handoff.
Maintainers
Readme
ai-scaffold
Structured AI collaboration for any repo — agent-agnostic dispatch, council deliberation, session handoff.
AI coding tools are powerful but stateless. Sessions drift. Context resets. Decisions get made without discipline. ai-scaffold gives your repo the structure your AI needs to stay oriented, consistent, and useful across sessions.
Usage
npm create @hasankhatib/ai-scaffold@latestRun this in any project directory. It asks 5 questions, then writes a SCAFFINIT.md file containing a ready-to-paste prompt. Paste that prompt into your AI (Claude Code, Cursor, OpenCode, Copilot — any of them) and it writes all the scaffold files.
What you get
AGENTS.md— rules your AI reads every session: what to always do, what to load on demand, when to invoke the councilCLAUDE.md— project overview, dev commands, hard rulesagents/council.md— 4-seat deliberation protocol for non-trivial decisionsagents/povs/— the 4 seat files chosen for your project typeagents/templates/decision-packet.md— structured template for council sessionsdocs/next.md— session handoff: where you left off, immediate next step, open threadsdocs/roadmap.md— phase status dashboardopencode.json— council agent config (OpenCode users)memory/MEMORY.md— memory index (optional, prompted during init)
The 5 questions
- What is this project? (one sentence)
- What kind of project is it? (app / tooling / R&D / personal)
- What is the primary tension you want the council to hold?
- What are your AI output boundaries?
- Do you want a memory system scaffold?
The council
The council is a 4-seat deliberation protocol for decisions where the cost of being wrong is high. Two seats are fixed (The Skeptic, The Editor); two are chosen based on your project type.
| Project type | Slot A | Slot B | |---|---|---| | App / product | The Shipper | The User | | Tooling / infra | The Operator | The Engineer | | R&D / research | The Researcher | The Domain Expert | | Personal OS | The Shipper | The Guardian |
Other install paths
OpenCode skill (install once, use in any project via the agent):
npx degit HasanKhatib/ai-scaffold/skills/ai-scaffold ~/.agents/skills/ai-scaffolddegit (copies the template directly, no interactivity):
npx degit HasanKhatib/ai-scaffold/template my-projectRequirements
Node 18+
