refactor(build): Move justfiles to context dirs, symlink .claude/

- Move justfiles from just/ to their context directories:
  - context/plugins/justfile
  - context/skills/justfile
  - context/commands/justfile
  - context/agents/justfile
  - context/rules/justfile

- Add default recipe to justfile (just --list)

- Migrate .claude/ content to context/:
  - agents: bd-task-agent, skill-pr-addresser, skill-reviewer dirs
  - skills: beads skill
  - rules: 14 project rules (pre-commit.md → pre-commit-project.md)

- Replace .claude/{agents,skills,rules} with symlinks to context/

- Archive completed plugin-build-system plan

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: aRustyDev

.archive/plans/plugin-build-system/analysis/plugin-component-audit.md

@@ -0,0 +1,129 @@
+# Plugin Component Audit
+
+Audit of existing plugins and potential shared components from `context/`.
+
+## Summary
+
+| Plugin | Status | Potential Shared Components |
+|--------|--------|----------------------------|
+| android-dev | Placeholder | api-designer, mobile-app-developer agents |
+| api-dev | Placeholder | api-designer, api-documenter, graphql-architect agents |
+| blog-workflow | List format | content-marketer, technical-writer agents |
+| browser-extension-dev | Partial | Has MCP/skills defined, needs agent mapping |
+| cad-dev | Placeholder | No matching components |
+| content-creation | Placeholder | content-marketer, seo-specialist agents |
+| frontend-dev | Placeholder | frontend-developer, react-specialist, vue-expert agents |
+| go-projects | Placeholder | golang-pro agent, convert skills |
+| homebrew-dev | Complete | Already migrated |
+| infrastructure | Placeholder | terraform-engineer, kubernetes-specialist agents |
+| ios-dev | Placeholder | swift-expert, mobile-app-developer agents |
+| job-hunting | No sources | No matching components |
+| mcp-server-dev | No sources | mcp-developer agent |
+| model-dev | Placeholder | ml-engineer, data-scientist agents |
+| pcb-design | No sources | embedded-systems agent (partial) |
+| rust-projects | No sources | rust-engineer agent, convert skills |
+| siem-ops | Placeholder | security-engineer, incident-responder agents |
+| terraform | No sources | terraform-engineer, cloud-architect agents |
+
+## Detailed Recommendations
+
+### Ready for Component Mapping
+
+These plugins could use existing context/ components:
+
+#### api-dev
+```json
+{
+  "agents/api-designer.md": "context/agents/api-designer.md",
+  "agents/api-documenter.md": "context/agents/api-documenter.md",
+  "agents/graphql-architect.md": "context/agents/graphql-architect.md"
+}
+```
+
+#### frontend-dev
+```json
+{
+  "agents/frontend-developer.md": "context/agents/frontend-developer.md",
+  "agents/react-specialist.md": "context/agents/react-specialist.md",
+  "agents/vue-expert.md": "context/agents/vue-expert.md",
+  "agents/nextjs-developer.md": "context/agents/nextjs-developer.md"
+}
+```
+
+#### go-projects
+```json
+{
+  "agents/golang-pro.md": "context/agents/golang-pro.md"
+}
+```
+
+#### infrastructure
+```json
+{
+  "agents/terraform-engineer.md": "context/agents/terraform-engineer.md",
+  "agents/kubernetes-specialist.md": "context/agents/kubernetes-specialist.md",
+  "agents/cloud-architect.md": "context/agents/cloud-architect.md"
+}
+```
+
+#### mcp-server-dev
+```json
+{
+  "agents/mcp-developer.md": "context/agents/mcp-developer.md"
+}
+```
+
+#### rust-projects
+```json
+{
+  "agents/rust-engineer.md": "context/agents/rust-engineer.md"
+}
+```
+
+#### siem-ops
+```json
+{
+  "agents/security-engineer.md": "context/agents/security-engineer.md",
+  "agents/incident-responder.md": "context/agents/incident-responder.md",
+  "agents/penetration-tester.md": "context/agents/penetration-tester.md"
+}
+```
+
+#### terraform
+```json
+{
+  "agents/terraform-engineer.md": "context/agents/terraform-engineer.md",
+  "agents/cloud-architect.md": "context/agents/cloud-architect.md"
+}
+```
+
+### Needs Custom Components
+
+These plugins have no matching components in context/:
+
+- **cad-dev**: Would need CAD-specific skills/agents
+- **pcb-design**: Would need PCB/electronics skills/agents
+- **job-hunting**: Would need career-focused components
+- **android-dev**: Has mobile-app-developer but may need Android-specific
+- **ios-dev**: Has swift-expert but may need iOS-specific
+
+### Planning Format (Skip Migration)
+
+- **blog-workflow**: Uses list format for planning, not buildable
+
+## Migration Priority
+
+1. **High value** (many matching components):
+   - infrastructure, terraform, api-dev, frontend-dev, siem-ops
+
+2. **Medium value** (some matching components):
+   - go-projects, rust-projects, mcp-server-dev
+
+3. **Low value** (few/no matching components):
+   - cad-dev, pcb-design, job-hunting, android-dev, ios-dev, content-creation, model-dev
+
+## Recommended Actions
+
+1. Update high-value plugins with real component mappings
+2. Keep placeholder sources for low-value plugins until domain-specific components exist
+3. Remove placeholder files (foo.md, bar.md) and use empty sources for plugins without shared components

.archive/plans/plugin-build-system/analysis/research-report.md

@@ -0,0 +1,120 @@
+# Context Component Build System
+
+**Created:** 2025-02-20
+**Updated:** 2025-03-16
+**Owner:** Claude Code AI
+
+Content-addressed build system for context component management with tiered distribution.
+
+## Problem
+
+- Component duplication across plugins
+- Version drift with no tracking
+- No standardized distribution for non-plugin components
+- Unclear relationships between plugins, skills, commands, agents
+
+## Solution
+
+Implement a tiered build and distribution system:
+
+1. **Justfile modules** for building each component type
+2. **Content-addressed hashing** for tracking source changes
+3. **Tiered distribution** via appropriate tools per component type
+4. **Validation gates** appropriate to each tier
+
+## Component Hierarchy
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  TIER 1: PLUGINS (Primary)                                  │
+│  Distribution: plugin-marketplace                           │
+│  Build: just plugin:build <name>                            │
+│  Validation: Full marketplace validation, versioning        │
+│  Contains: Skills, Commands, Agents, Rules, MCP configs     │
+├─────────────────────────────────────────────────────────────┤
+│  TIER 2: SKILLS (Secondary)                                 │
+│  Distribution: npx skills (Vercel Labs) ✓                   │
+│  Build: just skill:build <name>                             │
+│  Validation: SKILL.md structure, allowed-tools              │
+│  Contains: Commands, Agents, Rules (bundled)                │
+├─────────────────────────────────────────────────────────────┤
+│  TIER 3: COMMANDS & AGENTS (Tertiary)                       │
+│  Distribution: Bundle into skills (no dedicated CLI exists) │
+│  Build: just command:build, just agent:build                │
+│  Validation: Frontmatter, markdown lint                     │
+│  Contains: Self-contained                                   │
+├─────────────────────────────────────────────────────────────┤
+│  TIER 4: SUPPORTING COMPONENTS                              │
+│  Distribution: Bundled into higher tiers                    │
+│  Build: just rule:build, just mcp:build, just hook:build    │
+│  Validation: Format-specific                                │
+│  Types: Rules, Output Styles, MCP Configs, Hooks            │
+└─────────────────────────────────────────────────────────────┘
+```
+
+> **Note:** Prompts are NOT a separate component type. Commands are "prompts with slash triggers", rules are "headless prompts", and skills are "prompts with infrastructure". Use SKILL.md `type` metadata for distinctions.
+
+## Key Decisions
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| Promotion path | None | Components are distinct, refactor not promote |
+| Plugin skills | All referenced | Extract to context/skills/ first |
+| Build system | Justfile modules | `just plugin:build`, `just skill:build`, etc. |
+| Plugin distribution | plugin-marketplace | Established, works |
+| Skill distribution | **`npx skills` (Vercel)** | 547K/week downloads, 42 agents, skills.sh registry |
+| Command/Agent distribution | Bundle into skills | No dedicated CLI exists |
+| Source tracking | Extend plugin.sources.json | Track skill composition |
+| Prompts as component | **No** | Subsumed by skills/commands/rules |
+| Skill spec | SKILL.md (agentskills.io) | Industry standard (Anthropic, OpenAI, Microsoft, Google) |
+
+## Phases
+
+| Phase | Name | Goal | Status |
+|-------|------|------|--------|
+| 0 | Research | Document approach, audit components | ✅ Complete |
+| 0.5 | CLI Research | Evaluate distribution CLI options | ✅ Complete |
+| 1 | PoC | Hash generation and validation | ✅ Complete |
+| 2 | MVP | Stale detection + one plugin migration | ✅ Complete |
+| 3 | Full Build | Complete build system with justfile modules | ✅ Complete |
+| 4 | Migration | Migrate all plugins, implement skill tracking | ✅ Complete |
+| 5 | Distribution Gaps | Hook distribution, cross-agent rules (optional) | Proposed |
+
+## Documents
+
+| Document | Location |
+|----------|----------|
+| Component Audit | `analysis/plugin-component-audit.md` |
+| CLI Research Report | `analysis/research-report.md` |
+| Architecture Decision | `docs/src/adr/0003-plugin-build-system.md` |
+| Phase Plans | `phase/*.md` |
+
+## Research Questions (Resolved)
+
+| Question | Answer |
+|----------|--------|
+| Skills CLI? | **`npx skills`** (add-skill deprecated, openskills has 200x less adoption) |
+| Commands/Agents/Rules CLI? | **None exists** - bundle into skills |
+| Prompts as component? | **No** - subsumed by skills/commands/rules |
+
+## Distribution Gaps (Phase 5 Candidates)
+
+Ecosystem gaps with no existing tools:
+
+| Gap | Impact | Build Opportunity |
+|-----|--------|-------------------|
+| **Hook distribution** | No way to share hook configs | High - largest ecosystem gap |
+| **Cross-agent rule translation** | Different formats per agent | Medium - multi-agent teams |
+| **Skill dependency resolution** | No formal dependency graph | Medium - contribute to spec |
+| **AGENTS.md for Claude Code** | 3K+ GitHub upvotes, no response | Low - wait for Anthropic |
+
+See `analysis/research-report.md` for full details.
+
+## Quick Links
+
+- [Phase 0: Research](phase/0-research.md) ✓
+- [Phase 0.5: CLI Research](phase/0.5-cli-research.md)
+- [Phase 1: PoC](phase/1-poc.md)
+- [Phase 2: MVP](phase/2-mvp.md)
+- [Phase 3: Full Build](phase/3-full-build.md)
+- [Phase 4: Migration](phase/4-migration.md)

.archive/plans/plugin-build-system/index.md

@@ -0,0 +1,70 @@
+# Phase 0: Research
+
+**ID:** `phase-0`
+**Dependencies:** none
+**Status:** complete
+**Effort:** 4 hours
+
+Initial research and architecture planning for the plugin build system.
+
+## Goal
+
+Document the current state, identify problems, and design the high-level approach.
+
+## Deliverables
+
+### 1. Problem Statement
+
+Documented issues with current plugin management:
+- Component duplication across plugins (same agent copied to multiple plugins)
+- Version drift with no tracking mechanism
+- No standardized distribution for non-plugin components
+- Unclear relationships between plugins, skills, commands, agents
+
+### 2. Component Audit
+
+Analyzed all 18 existing plugins to identify:
+- Which have shared components
+- Which could use existing context/ components
+- Migration priority based on component reuse potential
+
+**Output:** `analysis/plugin-component-audit.md`
+
+### 3. Architecture Decision
+
+Decided on content-addressed build system with:
+- SHA256 hashing for change detection
+- `plugin.sources.json` for tracking source→plugin mappings
+- Tiered component hierarchy (Plugins > Skills > Commands/Agents > Supporting)
+
+### 4. Phase Plan
+
+Created phased implementation plan:
+- Phase 0.5: CLI Research (what tools exist for distribution)
+- Phase 1: PoC (hash generation and validation)
+- Phase 2: MVP (stale detection, one plugin migration)
+- Phase 3: Full Build (justfile modules, all component types)
+- Phase 4: Migration (all plugins)
+
+## Key Decisions Made
+
+| Decision | Choice | Rationale |
+|----------|--------|-----------|
+| Hash algorithm | SHA256 | Industry standard, fast, collision-resistant |
+| Build tool | Justfile | Already in use, supports modules |
+| Source tracking | plugin.sources.json | Extend existing format |
+| Change detection | Content-addressed | More reliable than timestamps |
+| Plugin distribution | plugin-marketplace | Already working, established |
+
+## Success Criteria
+
+- [x] Problem statement documented
+- [x] Component audit complete
+- [x] Architecture approach decided
+- [x] Phase plan created
+- [x] Key decisions documented
+
+## Notes
+
+- Phase 0.5 (CLI Research) was added after initial planning to research Tier 2-4 distribution options
+- homebrew-dev plugin identified as first migration candidate (already has sources)