DOCUMENTATION

How SCAFFOLD Works

Stop AI hallucinations. Build a complete blueprint, fill every required field, lock each spec, then export to any AI coder.

PROBLEM

AI generates different features every time. Adds things you never asked for.

SOLUTION

Build blueprint with AI help. Fill all required fields. Lock. Export frozen design.

OUTCOME

AI builds exactly what's locked. No drift. No surprises. Perfect consistency.

FOR NON-TECHNICAL FOUNDERS

You Don't Need to Know How to Code

WHAT YOU DO

→ Answer AI questions about your app
→ Review the blueprint AI generates
→ Fill in required details (plain English)
→ Lock when everything looks right

WHAT SCAFFOLD DOES

→ Asks clarifying questions
→ Generates organized categories
→ Shows exactly what's missing
→ Prevents locking until complete

COMPLETE WORKFLOW

From Idea to Locked Blueprint

STEP 1

Describe Your App & Answer Questions

Click "New Project" and describe your app in 2-3 sentences. AI asks clarifying questions like "Who will use this?" and "What's most important?"

# Example:

"I want to build an app where users can create invoices and get paid via Stripe."

# AI asks:

"Do users need accounts? Should invoices be sent via email? Any tax calculation?"

STEP 2

AI Generates Blueprint

Based on your answers, AI creates organized categories (Frontend, Backend, Database, etc.) with specific tasks inside each one.

Fill Required Fields (All 10)

Click on each task. SCAFFOLD shows exactly what's missing. You can ask AI to refine fields or fill them yourself in plain English.

REQUIRED FIELDS (10 TOTAL)

1. Business Value: Why this matters (60+ characters)
2. User Story: "As a [role], I want [action], so that [benefit]" (40+ characters)
3. Requirements: At least 5 specific requirements
4. Design: Architecture, data flow (40+ characters)
5. Tasks: Implementation steps with dependencies
6. Testing: At least 3 test scenarios with validation steps
7. AI Instructions: Style, patterns, constraints for AI coder
8. Security: Authentication, authorization, data protection (mandatory)
9. Integrations: External services, APIs, error handling
10. Deployment: Environment variables, rollback procedure

You can't lock until all 10 fields are filled. SCAFFOLD shows a checklist for each spec.

STEP 4

Lock Each Specification

Once all required fields are filled and dependencies are correct, you can lock. Locked specs cannot be changed.

WHAT LOCKING DOES

✓ Freezes this spec permanently
✓ Prevents AI from changing it
✓ Makes it exportable

LOCK REQUIREMENTS

! All 10 fields completely filled
! All dependencies already locked
! No circular dependencies

STEP 5

Export to AI Coder

After locking all specs, export your blueprint. Give it to Claude, Cursor, or any AI coder. They build exactly what you locked.

TWO EXPORT OPTIONS

Download File

One-time export. Attach file when prompting AI.

MCP Live Sync

AI always sees latest locked specs. No manual exports.

LOCKING RULES

When You Can Lock (and Why)

Why Locking Exists

Without locking, AI changes your specs every time you ask a question. Locking freezes your decisions so AI can't drift.

WITHOUT LOCKING

• AI adds random features
• Different results every prompt
• No consistency guarantee

WITH LOCKING

• Frozen specifications
• AI builds exact design
• 100% consistency

Lock Requirements Checklist

✓

All 10 Required Fields Filled

Business value, user story, requirements, design, tasks, testing, AI instructions, security, integrations, deployment

✓

All Dependencies Locked

If this spec depends on other specs, those must be locked first

✓

No Circular Dependencies

Spec A can't depend on Spec B if Spec B depends on Spec A

Dependencies Determine Build Order

Dependencies define what must be built first. SCAFFOLD validates this automatically.

EXAMPLE BUILD ORDER

1Database schema → stores user data

↓ (dependency)

2Login system → checks database for users

↓ (dependency)

3Dashboard → shows logged-in user's data

You can't lock Dashboard until Login is locked. You can't lock Login until Database is locked.

EXPORT

Give Your Blueprint to AI

OPTION 1

Download Blueprint

Export locked blueprint as a file. Attach when prompting Claude or Cursor.

# Example prompt:

"Build this app exactly as described. Do not add features."

[Attach blueprint.json]

✓ Works with any AI coder

✓ One-time export

✓ Perfect for testing

OPTION 2

MCP Connection

Connect to Claude Desktop, Cursor, or Windsurf. They always see your latest locked specs.

BENEFITS

• Real-time sync
• No manual exports
• Works across devices
• AI always has latest version

✓ Starter plan and above

✓ Live updates

✓ Best for active projects

Need Help?

Can't find what you're looking for? Contact support.

Contact Support