BuildCrew

The Build Crew for AI Development

A collection of custom AI agents, skills, and commands for software development teams. Installable across multiple AI coding platforms including OpenCode, Claude, and GitHub Copilot.

Overview

BuildCrew provides role-based development agents and technology-specific skills that enhance AI-assisted coding workflows:

• Agents - Specialized AI personas (Architect, Build, Plan, etc.)
• Skills - Technology and framework-specific knowledge packs
• Commands - Reusable prompt templates for common development tasks

Quick Start

No need to clone this repository. Install directly with npx:

# Install BuildCrew recipes for your platform
npx @rezmuh/buildcrew install copilot

# Or install into user-level config
npx @rezmuh/buildcrew install opencode -u

Supported platforms: opencode, claude, copilot

CLI Installation

For frequent use, install the CLI globally:

npm install -g @rezmuh/buildcrew

# Then use it directly
buildcrew install copilot
buildcrew install opencode -u

NixOS and Declarative Environments

On NixOS or other declarative systems, npm install -g may not work because global directories are read-only. Use npx instead — it does not require global installation:

# This works on NixOS, macOS, Linux, and Windows
npx @rezmuh/buildcrew install copilot
npx @rezmuh/buildcrew install opencode -u

Alternatively, install locally in your project:

npm install -D @rezmuh/buildcrew
npx buildcrew install copilot

Commands

install <platform>

Install or update BuildCrew recipes for a platform.

# Install into current project (default)
buildcrew install copilot
buildcrew install claude
buildcrew install opencode

# Install into a specific project directory
buildcrew install copilot -t ./my-project

# Install into user-level config
buildcrew install opencode -u

# Preview changes without applying
buildcrew install copilot --dry-run

# Force overwrite conflicting files
buildcrew install copilot --force

uninstall <platform>

Remove BuildCrew recipes for a platform.

buildcrew uninstall copilot
buildcrew uninstall claude -t ./my-project

doctor <platform>

Check the status of installed recipes.

buildcrew doctor copilot
buildcrew doctor opencode -u

list

List available platforms or recipes.

buildcrew list platforms
buildcrew list

Platform Outputs

OpenCode

• .opencode/agent/*.md
• .opencode/skills/*/*.md
• .opencode/command/*.md

Claude

• CLAUDE.md (agent instructions as marked sections)
• .claude/skills/*.md
• .claude/commands/*.md

GitHub Copilot

• .github/copilot-instructions.md (agent instructions as marked sections)
• .github/skills/*.md
• .github/prompts/*.prompt.md

Repository Structure

buildcrew/
├── agents/          # Role-based AI agents
│   ├── architect.md
│   ├── build.md
│   └── plan.md
├── skills/          # Technology-specific skills
│   ├── react/
│   ├── kubernetes/
│   └── _template/
├── commands/        # Reusable command prompts
│   ├── review.md
│   └── refactor.md
├── src/             # CLI source code
│   ├── cli.js
│   ├── commands/
│   ├── platforms/
│   └── utils/
├── bin/             # CLI entry point
│   └── buildcrew.js
├── manifest.json    # Package manifest
└── package.json

Agents

Architect

The Architect agent designs system architecture, makes technology decisions, and creates high-level implementation plans. It focuses on structure over code.

Build

The Build agent implements features by writing code, making edits, and executing commands. It has full edit permissions and is the primary coding agent.

Plan

The Plan agent creates detailed implementation plans before coding begins. It can only write to .opencode/plans/ (or equivalent plan directories) to avoid premature implementation.

Customizing Agents

To customize an agent for your project:

1. Install BuildCrew for your platform
2. Edit the installed files directly (they are marked with BuildCrew comments)
3. Or fork this repo, modify agents/, and publish your own package

Contributing

1. Add new agents to agents/ following the template in agents/_template.md
2. Add skills to skills/<name>/SKILL.md
3. Update manifest.json if adding new file types
4. Test with node bin/buildcrew.js install <platform> --dry-run

Publishing to npm

1. Ensure you have an npm account. Sign up at npmjs.com
2. Log in via CLI:

   npm login

3. Publish (scoped packages require --access public on first publish):

   npm publish --access public

4. For subsequent publishes, just bump the version in package.json and:

   npm version patch  # or minor/major
   npm publish

License

MIT