Initialize a new repository with standard scaffolding - git, gitignore, CLAUDE.md, justfile, mise, and beads. Use when starting a new project or setting up an existing repo for Claude Code workflows.
Sign in to like and favorite skills
Scaffold a new or existing repository with standard project infrastructure.
Related skills:
Creates universal scaffolding that works across all project types:
| File | Purpose |
|---|---|
| Standard ignores + language-specific patterns |
| Project conventions for Claude Code |
| Build system skeleton |
| Tool version pinning (empty, ready for |
| Issue tracking database |
| Environment variable template |
1. Gather context (language, project type) 2. Create scaffolding 3. Initialize beads 4. Point to language skill for next steps
Before scaffolding, clarify:
Use AskUserQuestion if unclear from context.
# Initialize git if needed git init # Create .gitignore with common patterns
Each language skill provides a comprehensive
.gitignorereferences/.env.envrc.DS_StoreThumbs.dbCopy from the appropriate language skill:
| Language | Source |
|---|---|
| Go | |
| Rust | |
| TypeScript | |
| Python | |
For multi-language repos: Start with the primary language's gitignore, then merge patterns from others as needed.
Minimal fallback (if language skill unavailable):
# Environment .env .env.local .env.*.local .envrc # OS .DS_Store Thumbs.db # IDE .idea/ .vscode/ # Build (customize per language) dist/ build/ target/ node_modules/ __pycache__/
Create project conventions file for Claude Code:
# Project Name - Claude Instructions ## Overview Brief description of what this project does. ## Development ```bash just setup # First-time setup just check # Run all quality gates
Keep it minimal initially. Add conventions as they emerge. --- ## Step 4: Justfile Skeleton ```just # Project Build System # Usage: just --list default: @just --list # First-time setup setup: mise trust mise install @echo "Ready. Run 'just check' to verify." # Quality gates - add language-specific checks check: @echo "Add fmt, lint, test recipes" # Remove build artifacts clean: @echo "Add clean commands"
For language-specific recipes, see:
package-go.justpackage-rust.justCreate empty
.mise.toml[tools] # Add tools with: mise use <tool>@<version> # Examples: # node = "22" # go = "1.25" # rust = "1.83" # just = "latest"
bd init -q
This creates
.beads/For teams, consider:
bd init --teambd init --stealthCreate
.envrc.example.envrc# Copy to .envrc and fill in values # cp .envrc.example .envrc && direnv allow # Mise integration if command -v mise &> /dev/null; then eval "$(mise hook-env -s bash)" fi # Project-specific environment # export DATABASE_URL="postgres://localhost/myapp" # export API_KEY=""
After scaffolding, point user to language-specific setup:
| Language | Next Step |
|---|---|
| Go | Invoke go-pro skill, run |
| Rust | Invoke rust-pro skill, run |
| TypeScript | Invoke typescript-pro skill, run |
| Multi-language | Follow each lang skill for respective packages |
# Full init sequence git init # Create .gitignore, CLAUDE.md, justfile, .mise.toml, .envrc.example bd init -q mise use just@latest # Then follow language skill for specifics
For monorepos, the root gets:
justfile.mise.toml.beads/Each package gets:
justfile