/ FAQ

Frequently asked questions

Answers grounded in what the platform actually does today. If your question isn't here, the Help Center has more detail.

What is Modular Chunks?

An AI-powered project planning and build orchestration platform. Instead of feeding an AI a vague prompt and hoping for a complete app, Modular Chunks breaks your product into small, self-contained "chunks" — each one a precisely scoped unit of work with its own coding instructions, data models, API endpoints, validation contracts, and UML diagram.

Does Modular Chunks write code?

No. Modular Chunks plans, validates, and feeds chunk contracts to your coding tool of choice (Cursor, Claude Code, Windsurf, Aider, Factory, Bolt.new, Lovable, v0, etc.). The CLI also exposes an MCP server so any MCP-compatible agent can pull chunk context directly.

What are the 11 stages?

Pre-flight (00) → Venture Intake (01) → Project Brief (02) → Technical Architecture (03) → PRD (03b) → Design Intake (04, hard gate) → Chunk Blueprints (05) → Logic Explainer (06) → Node Assembly (07) → CLI Execution (08) → Build Dashboard (09) → Roadmap (10) → Council (11). Every stage feeds the next; the design intake is a hard gate before any chunk is generated.

Why is design intake a hard gate?

So design instructions are baked into every downstream chunk. The blueprint generator refuses to run without captured design preferences (UI kit, density, motion, accessibility level, color mode). The CLI mirrors this — `chunky start` prompts for the same selection between PRD and blueprint generation.

Can I import an existing codebase?

Yes. The Audit stage scans an existing repository and produces a health score, architecture summary, tech-debt findings, and a critical / high issue list. Those findings flow into the brief and roadmap.

Which coding agents are supported?

Cursor, Claude Code, Windsurf, GitHub Copilot, Aider, Factory, Bolt.new, Lovable, v0. The CLI's MCP server exposes 19 tools, so any MCP-compatible agent works. Pre-flight pre-selects a tool and formats chunk prompts accordingly.

How does the platform pick a guideline / playbook for me?

Pre-flight captures two orthogonal signals: the deliverable (what you're building — SaaS, mobile, CLI, smart contract, …) and the industry (who it's for — fintech, healthcare, devtools, …). The deliverable hard-binds your tech stack (mobile picks never get a Next.js stack); the industry adds soft defaults (healthcare prefers BAA-eligible vendors even before you tick HIPAA). Compliance flags (HIPAA, SOC 2, GDPR, PCI-DSS, FedRAMP, ISO 27001) take precedence over both. You can override any individual standard on the Playbooks & Guidelines page.

Is my data shared with other users?

No, unless you invite them. Each project is owned by its creator and protected by row-level security in Supabase. The owner can invite collaborators (member or viewer roles) from the Project Settings page; only invited members can read or edit. Standards (deliverable rules, industry defaults, playbooks, guidelines) are seeded read-only from the platform catalog and editable copies are stored per-account.

How do I export a stage?

Project Brief, Technical Architecture, PRD, Chunk Blueprints, and Roadmap each have a Download menu (PDF, HTML, JSON) in the page banner. The export captures every field shown on the page.

Is there a CLI?

npm install -g modular-chunks-cli — currently version 0.13. The CLI ships 40+ commands and an MCP server with 19 auto-registered tools. See the CLI page for details.

How much does it cost?

$5 / month for 500,000 tokens included, or $50 / year (17% off). Pay-as-you-go after that at $0.50 per 100,000 tokens. 14-day free trial, no card up-front. Refunds within 14 days. Set a hard monthly cap so you can't be surprised. Billing runs on LemonSqueezy; manage your plan from /account/billing. Full details on the Pricing page.

Do I get notifications when chunks are ready?

Yes. You can opt in to email, Web Push (mobile + desktop), and personal Slack DMs from /account/notifications. Granular per-event toggles cover chunk approval, autopilot stalled / completed, payment failed, spend cap approaching, new device sign-in, API key created, and the SDLC recurring tasks. Defaults are sensible — most people leave them on.

Will my chunks survive if I close the tab mid-generation?

Yes. Chunk generation runs on Inngest as a durable parallel-DAG workflow. The browser polls / receives realtime updates while the tab is open, but the workflow itself runs server-side and completes whether or not you're watching. Email + Web Push fire on completion. Come back hours later and the chunks are waiting.

Where do I get help?

The Help Center has setup guides for every supported coding tool, troubleshooting articles, and CLI reference. The Council (an in-platform multi-advisor chat) answers architectural and design questions once you're signed in.