ai-driven-bootstrap

Bootstrap AI-assisted projects from a CLI interview, not a blank repo.

This repository defines a scaffolder that should ask a few setup questions, generate the initial project docs and agent files, and leave the user with a ready-to-edit repository.

What this is

A future npm / pnpm dlx CLI for initializing AI-assisted projects with a consistent documentation and agent setup.

• A short interactive interview
• Generated project docs such as overview.md, requirements.md, architecture.md, decisions.md, and tasks.md
• A standard workflow for how humans and AI should collaborate after bootstrap
• Generated agent guidance such as AGENTS.md and optional agent-specific files
• A minimal, agent-agnostic starting structure

What this is not

• A finished starter app for a specific framework
• A language-specific full stack scaffold
• A replacement for product decisions or architecture thinking

Who this is for

Developers and teams who want to:

• Start a new AI-assisted project from one command
• Answer a short set of questions instead of manually editing multiple docs first
• Keep AI agents aligned across sessions with generated written context

Who this is not for

• Teams looking for a production-ready framework starter
• Projects that already have a settled internal bootstrap workflow

Status

Pre-release. The CLI is not yet published to npm.

This repository is the design and planning stage for the tool. See docs/ for the current product definition, requirements, and architecture.

How to use (once published)

1. Run npx ai-driven-bootstrap init or pnpm dlx ai-driven-bootstrap init
2. Answer the setup questions
3. Review the generated docs and agent files
4. Start building with your AI agent of choice

The generated docs become the source of truth for the new project. This repository is the source of truth for how that bootstrap process should work.

Contents

AGENTS.md           shared rules for AI agents working on this repository
CLAUDE.md           Claude Code-specific instructions for this repository
docs/
  overview.md       product definition for the bootstrap CLI
  requirements.md   functional and non-functional requirements
  architecture.md   system design for the scaffolder
  decisions.md      architecture decision log
  tasks.md          prioritized execution plan
  intake.md         question set for the CLI interview flow
  workflow.md       standard AI-assisted development workflow

License

MIT — see LICENSE