delivery-bootstrap

Delivery Bootstrap Skill

Just-in-Time tech stack detection and setup.

Workflow

1. Check product_type from .claude/diamonds/active.yml:
   • If product_type is set (from /mycelium:interview), use it to determine the delivery profile.
   • If not set, scan for indicators per ${CLAUDE_PLUGIN_ROOT}/jit-tooling/detector.md Step 1b:
     • Curriculum/lesson plans, LMS config -> content_course
     • Manuscript/chapters, editorial calendar -> content_publication
     • Video scripts, subtitle files, podcast RSS -> content_media
     • Prompt templates, model configs, agent definitions -> ai_tool
     • Service blueprints, pricing docs -> service_offering
   • If non-software product_type detected: skip software tooling detection (Steps 2-3 below), configure product-type-appropriate validation instead, and proceed to Step 4.

1b. Scan project root for technology indicators (software and ai_tool with code):

• Package files: package.json, Cargo.toml, go.mod, requirements.txt, pyproject.toml, Gemfile, pom.xml, build.gradle
• Config files: tsconfig.json, .eslintrc, .prettierrc, rustfmt.toml, .editorconfig
• CI/CD: .github/workflows, .gitlab-ci.yml, Jenkinsfile, Dockerfile
• Framework indicators: next.config.js, nuxt.config.ts, angular.json, etc.

2. Identify stack components (software/ai_tool with code):

   • Language(s) and version(s)
   • Framework(s)
   • Package manager
   • Test runner and framework
   • Linter and formatter
   • Build tool
   • CI/CD platform
   • Database (if detectable)
   • Deployment target

3. Verify tooling works:

   • Run build command
   • Run test command
   • Run lint command
   • Note any failures or warnings

4. Document existing patterns:

   • Code organization (monorepo, src layout, etc.)
   • Naming conventions
   • Test patterns
   • Error handling patterns
   • API patterns

5. Scaffold Architecture Decision Records (if applicable):

   • Check: Does the project have significant architecture decisions ahead? Indicators:
     • Multiple competing implementation approaches (e.g., REST vs GraphQL, monolith vs microservices)
     • New infrastructure choices (database, hosting, auth provider)
     • Framework selection or migration
     • Integration with external systems
   • If yes: create docs/adr/ directory and a template file docs/adr/0000-template.md:

     # [NUMBER]. [TITLE]
     
     Date: [DATE]
     
     ## Status
     Proposed | Accepted | Deprecated | Superseded by [ADR-XXXX]
     
     ## Context
     What is the issue that we're seeing that is motivating this decision?
     
     ## Decision
     What is the change that we're proposing and/or doing?
     
     ## Consequences
     What becomes easier or more difficult to do because of this change?
     

   • If no significant architecture decisions are foreseeable: skip. Don't scaffold ceremony for a weekend project.
   • ADR format: Nygard (Context/Decision/Consequences). Lightweight by design — each ADR should be readable in under 2 minutes.

6. Output:

   ## Stack Profile
   - Language: [x] v[y]
   - Framework: [x]
   - Package manager: [x]
   - Test: [command] ([framework])
   - Lint: [command]
   - Build: [command]
   - CI/CD: [platform]
   
   ## Commands
   - Install: [command]
   - Dev server: [command]
   - Test: [command]
   - Build: [command]
   - Lint: [command]
   
   ## Observed Patterns
   - [list of patterns detected]
   
   ## Issues Found
   - [any broken tooling or warnings]
   
   ## Architecture Decision Records
   - Scaffolded: yes/no
   - Location: docs/adr/
   - Pending decisions: [list if any identified during bootstrap]
   

Rules

• Use the project's established patterns. Don't impose external preferences.
• Be language-agnostic in principles, language-specific in implementation.
• If tooling is broken, flag it rather than silently working around it.

Canvas Output

Create/update ${CLAUDE_PLUGIN_ROOT}/jit-tooling/active-stack.yml with detected stack configuration. See ${CLAUDE_PLUGIN_ROOT}/jit-tooling/active-stack.example.yml for the expected format.

Theory Citations

• Forsgren: Accelerate (tooling and automation)
• Smart: Sooner Safer Happier (remove friction)
• Nygard: Architecture Decision Records (lightweight decision documentation)