Qor Bootstrap

ABORT
Report: "Integrity Violation: Genesis already exists. Use /qor-status to resume."

Step 2.5: Repository Readiness Check

Git State: Run git status --porcelain. Warn if uncommitted changes exist.

Gold Standard Check: If no .github/ and no SECURITY.md, run /qor-repo-scaffold silently.

Branch Creation: git checkout -b feat/[project-name]-genesis

Step 3: Create Directory Structure

Ensure required directories exist: .agent/, .failsafe/governance/, docs/

Step 3.5: Privacy Configuration

Ask user: "Is this repository public/open-source or private?"

For public repos, verify .gitignore includes AI governance patterns. Add missing patterns.

Template: references/qor-bootstrap-templates.md.

Step 3.5b: Collaborative Design Dialogue

Before writing CONCEPT.md, engage in collaborative dialogue:

1. Check project context first — read existing files, docs, recent commits
2. Ask questions one at a time — prefer multiple choice when possible
3. Focus on understanding: purpose, constraints, success criteria, anti-goals
4. Propose 2-3 approaches with trade-offs before settling on architecture
5. Present design in sections (200-300 words) — validate each before proceeding
6. YAGNI ruthlessly — challenge every proposed feature: "Is this essential for v1?"

Only proceed to write CONCEPT.md after the user has validated the design direction.

Step 4: ALIGN (The "Why")

Create docs/CONCEPT.md with Why (one sentence), Vibe (three keywords), and Anti-Goals.

Template: references/qor-bootstrap-templates.md.

Ask the user for the "Why" and "Vibe" keywords. If they can't explain it simply, reject the task.

Step 5: ENCODE (The "Promise")

Create docs/ARCHITECTURE_PLAN.md with risk grade, file tree, interface contracts, data flow, dependencies, and Section 4 pre-check.

Template: references/qor-bootstrap-templates.md.

Step 6: Initialize META_LEDGER

Create docs/META_LEDGER.md with genesis entry.

Template: references/qor-bootstrap-templates.md.

Step 6.5: Create Backlog

Create docs/BACKLOG.md with blocker/backlog/wishlist structure.

Template: references/qor-bootstrap-templates.md.

Step 7: Calculate Genesis Hash

import hashlib
combined = read_file("docs/CONCEPT.md") + read_file("docs/ARCHITECTURE_PLAN.md")
genesis_hash = hashlib.sha256(combined.encode()).hexdigest()

Step 8: Routing Decision

Note: Bootstrap is for workspace genesis only. For new features, use /qor-plan.

Step 9: Final Report

Report project name, genesis hash, risk grade, created artifacts, and next action.

Template: references/qor-bootstrap-templates.md.

Constraints

• NEVER bootstrap over existing DNA (check first)
• NEVER skip the "Why" documentation
• NEVER assign L1 to anything touching security/auth
• NEVER leave secrets in code — rotate, rewrite history, then gitignore (GR-1)
• NEVER force-push to shared branches without GR-2 coordination protocol
• NEVER open a PR without verifying branch lineage against origin/main (GR-3)
• ALWAYS calculate and record genesis hash
• ALWAYS require /qor-audit for L2/L3 before implementation
• ALWAYS configure secret scanning (pre-commit hook + CI) as part of genesis
• ALWAYS enable branch protection rules in governance plan (Restrict force pushes on main/staging)

Success Criteria

Bootstrap succeeds when:

• CONCEPT.md exists with clear "Why" statement
• ARCHITECTURE_PLAN.md exists with file tree and risk assessment
• META_LEDGER.md exists with genesis entry and hash
• BACKLOG.md exists with template structure
• Genesis hash calculated and recorded
• Risk grade properly assigned (L1/L2/L3)
• Required directories created (.failsafe/governance/, docs/)
• Routing decision provided based on risk grade

Integration with S.H.I.E.L.D.

This skill implements:

• Genesis Protocol: Seeds the Merkle-chain DNA for new projects
• Risk-Based Routing: Routes to appropriate gate based on risk grade
• Hash Chain Initialization: Establishes cryptographic audit trail from genesis
• Documentation-First: Requires concept and architecture before implementation

Remember: Genesis is the foundation. A weak genesis compromises the entire chain.