Polish: 9.5 → 10/10

- Update CLAUDE.md: Mark bootstrap duplication as RESOLVED, add bats tests as FUTURE enhancement
- Centralize color codes: Scripts now source bootstrap/lib.sh instead of defining their own
- Add CONTRIBUTING.md: Basic contribution guidelines for templates, agents, and scripts

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

Author: TaylorHonaker

CLAUDE.md

@@ -75,8 +75,9 @@ codebase-optimizer/
 
 | Item | Location | Priority | Notes |
 |------|----------|----------|-------|
-| Bootstrap script duplication | `bootstrap/` | MEDIUM | 3 scripts share ~60% logic |
+| Bootstrap script duplication | `bootstrap/` | RESOLVED | Shared library pattern implemented via `lib.sh` |
 | Windows native scripts | `scripts/` | LOW | Requires WSL/Git Bash |
+| Bats test suite | `tests/` | FUTURE | Add automated tests for scripts (enhancement) |
 
 ---
 
@@ -129,5 +130,5 @@ claude "Run performance-profiler on lib/"
 ## Contact
 
 **Owner**: AI Company USA
-**Last Updated**: 2026-01-27
+**Last Updated**: 2026-01-28
 **Review Cycle**: Quarterly

CONTRIBUTING.md

@@ -0,0 +1,173 @@
+# Contributing to Codebase Optimizer
+
+Guidelines for customizing and extending the codebase-optimizer framework.
+
+---
+
+## Getting Started
+
+1. **Fork or clone** this repository
+2. **Run installation**: `./scripts/install.sh --all`
+3. **Verify setup**: `claude "Run codebase-optimizer on agents/"`
+
+---
+
+## Customizing Templates
+
+### Adding a New Stack Template
+
+1. Copy the base template:
+   ```bash
+   cp templates/CLAUDE.md.template templates/CLAUDE-yourstack.md
+   ```
+
+2. Update required sections:
+   - **Repository Identity**: Stack-specific description
+   - **Tech Stack**: Technologies and versions
+   - **Code Conventions**: Stack-specific patterns
+   - **Critical Rules**: MUST/MUST NOT for this stack
+   - **Known Technical Debt**: Common issues
+   - **Common Pitfalls**: Stack-specific gotchas
+
+3. Validate your template:
+   ```bash
+   ./scripts/validate-templates.sh templates/CLAUDE-yourstack.md
+   ```
+
+### Template Requirements
+
+- All templates must have 50+ lines
+- Required sections (see `validate-templates.sh`):
+  - Repository Identity
+  - Tech Stack
+  - Code Conventions
+  - Critical Rules
+  - Known Technical Debt
+  - Common Pitfalls
+- No placeholder text (`TODO`, `PLACEHOLDER`, `TBD`)
+- Code blocks should have language tags
+
+---
+
+## Adding Custom Agents
+
+### Agent File Structure
+
+Create new agents in `agents/` with this structure:
+
+```markdown
+---
+name: your-agent-name
+description: Brief description of what the agent does
+tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+---
+
+# Your Agent Name
+
+[Full prompt and instructions here]
+
+## Execution Rules
+
+1. Rule one
+2. Rule two
+...
+```
+
+### Agent Requirements
+
+- Valid YAML frontmatter with `---` delimiters
+- `name` and `description` fields required
+- `tools` array specifying allowed tools
+- Clear execution rules section
+- No hardcoded secrets or API keys
+
+### Testing Your Agent
+
+```bash
+claude "Run your-agent-name on src/"
+```
+
+---
+
+## Modifying Scripts
+
+### Coding Standards
+
+All shell scripts must:
+- Use `set -e` for error handling
+- Source `bootstrap/lib.sh` for colors and utilities
+- Include usage documentation in header comments
+- Use proper cleanup with `trap` for critical operations
+
+### Shared Library (`bootstrap/lib.sh`)
+
+Use the shared library for:
+- Color codes: `$RED`, `$GREEN`, `$YELLOW`, `$BLUE`, `$NC`
+- Logging: `log_phase`, `log_success`, `log_error`, `log_warning`, `log_info`
+- Banners: `show_banner`, `show_completion_banner`
+- Utilities: `require_command`, `validate_file`
+
+Example:
+```bash
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$(dirname "$SCRIPT_DIR")/bootstrap/lib.sh"
+
+log_phase "Starting process"
+log_success "Completed"
+```
+
+---
+
+## Pull Request Process
+
+1. **Run validation** before submitting:
+   ```bash
+   ./scripts/validate-templates.sh
+   ```
+
+2. **Run codebase-optimizer** on your changes:
+   ```bash
+   claude "Run codebase-optimizer on the files I modified"
+   ```
+
+3. **Ensure no regressions**:
+   - All scripts have `set -e`
+   - No hardcoded secrets
+   - Documentation updated if needed
+
+4. **Commit message format**:
+   ```
+   <type>: <description>
+
+   Types: feat, fix, docs, refactor, test, chore
+   ```
+
+---
+
+## Windows Users
+
+Shell scripts require Unix-like environment:
+- **Git Bash** (included with Git for Windows)
+- **WSL** (Windows Subsystem for Linux)
+- **Docker** (run scripts in container)
+
+---
+
+## Questions?
+
+Open an issue for:
+- Bug reports
+- Feature requests
+- Template suggestions
+- Documentation improvements
+
+---
+
+*Last updated: 2026-01-28*

scripts/install.sh

@@ -66,12 +66,8 @@ REPO_DIR="$(dirname "$SCRIPT_DIR")"
 CLAUDE_DIR="$HOME/.claude"
 AGENTS_DIR="$CLAUDE_DIR/agents"
 
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
+# Source shared library for colors and utilities
+source "$REPO_DIR/bootstrap/lib.sh"
 
 # Flags
 INSTALL_AGENTS=false

scripts/validate-templates.sh

@@ -14,11 +14,9 @@
 
 set -e
 
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
+# Source shared library for colors and utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$(dirname "$SCRIPT_DIR")/bootstrap/lib.sh"
 
 # Required sections for all CLAUDE.md templates
 REQUIRED_SECTIONS=(

scripts/weekly-audit.sh

@@ -29,17 +29,15 @@
 
 set -e
 
+# Source shared library for colors and utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$(dirname "$SCRIPT_DIR")/bootstrap/lib.sh"
+
 REPO_PATH="${1:-.}"
 OUTPUT_DIR="${2:-$REPO_PATH/docs/audits}"
 DATE=$(date +%Y-%m-%d)
 TIMESTAMP=$(date +%Y-%m-%d_%H-%M-%S)
 
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
 # ═══════════════════════════════════════════════════════════════════════════════
 # Error Recovery Setup
 # ═══════════════════════════════════════════════════════════════════════════════