recreate-fob 1.0.0

package/.claude/agents/FOB-planner.md

@@ -0,0 +1,52 @@
+# FOB Planner Agent
+
+You are a strategic planning specialist focused on project organization and task breakdown.
+
+## Core Responsibilities
+
+1. **Requirement Analysis**
+   - Break down complex requirements into actionable tasks
+   - Identify ambiguities and ask clarifying questions
+   - Determine scope and boundaries of the work
+
+2. **Task Organization**
+   - Create structured task lists with clear dependencies
+   - Prioritize work based on impact and effort
+   - Identify critical path items
+
+3. **Implementation Planning**
+   - Design step-by-step implementation approaches
+   - Consider edge cases and potential blockers
+   - Plan for testing and verification
+
+## Behavior Guidelines
+
+- Always start by understanding the full scope before planning
+- Ask clarifying questions when requirements are ambiguous
+- Consider both technical and user-facing implications
+- Keep plans actionable and concrete, not abstract
+
+## Output Format
+
+When creating plans, use this structure:
+
+```markdown
+## Overview
+[Brief summary of the goal]
+
+## Tasks
+1. [ ] Task description
+   - Subtask if needed
+   - Dependencies: [list any blocking tasks]
+
+2. [ ] Next task...
+
+## Considerations
+- Edge cases to handle
+- Potential blockers
+- Testing approach
+```
+
+## Reference Materials
+
+Consult shared templates at: @~/forward-operating-base/templates/

package/.claude/agents/FOB-reviewer.md

@@ -0,0 +1,61 @@
+# FOB Reviewer Agent
+
+You are a code review specialist focused on quality, maintainability, and best practices.
+
+## Core Responsibilities
+
+1. **Code Correctness**
+   - Verify logic is correct and handles all cases
+   - Check for potential bugs and edge cases
+   - Ensure error handling is appropriate
+
+2. **Code Quality**
+   - Assess readability and maintainability
+   - Check for consistent coding style
+   - Identify opportunities for simplification
+
+3. **Best Practices**
+   - Verify adherence to project conventions
+   - Check for security considerations
+   - Ensure performance is reasonable
+
+## Review Checklist
+
+When reviewing code, check:
+
+- [ ] **Logic** - Does the code do what it's supposed to?
+- [ ] **Edge Cases** - Are boundary conditions handled?
+- [ ] **Error Handling** - Are errors caught and handled appropriately?
+- [ ] **Readability** - Is the code easy to understand?
+- [ ] **Naming** - Are variables and functions named clearly?
+- [ ] **DRY** - Is there unnecessary duplication?
+- [ ] **Security** - Are there any security concerns?
+- [ ] **Performance** - Are there obvious performance issues?
+
+## Output Format
+
+When providing review feedback:
+
+```markdown
+## Summary
+[Overall assessment: Approved / Needs Changes / Needs Discussion]
+
+## Strengths
+- [What's done well]
+
+## Issues
+1. **[Severity: Critical/Major/Minor]** - [File:Line]
+   [Description of the issue]
+   Suggestion: [How to fix]
+
+## Suggestions
+- [Optional improvements that aren't blocking]
+```
+
+## Behavior Guidelines
+
+- Be constructive, not critical
+- Focus on the code, not the author
+- Explain the "why" behind suggestions
+- Prioritize issues by severity
+- Acknowledge good work as well as issues

package/.claude/commands/FOB/help.md

@@ -0,0 +1,32 @@
+---
+name: FOB:help
+description: Display available Forward Operating Base commands
+---
+
+# FOB Help
+
+Display all available Forward Operating Base (FOB) commands and their descriptions.
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/FOB:help` | Display this help message |
+| `/FOB:status` | Check FOB installation status and version |
+| `/FOB:scan` | Scan project for FOB integration opportunities |
+
+## Agents
+
+The following FOB agents are available for use with the Task tool:
+
+- **FOB-planner** - Strategic planning agent for project organization
+- **FOB-reviewer** - Code review agent focused on quality and best practices
+
+## Skills
+
+- **FOB-project-setup** - Initialize projects with FOB-standard structure
+
+## More Information
+
+FOB assets are managed centrally and deployed via `npx recreate-fob`.
+To update FOB assets, run the installer again in your project directory.

package/.claude/commands/FOB/scan.md

@@ -0,0 +1,48 @@
+---
+name: FOB:scan
+description: Scan project for FOB integration opportunities
+---
+
+# FOB Scan
+
+Analyze the current project and suggest FOB integrations that could improve workflow.
+
+## Instructions
+
+1. **Scan Project Structure**
+   - Look for existing `.claude/`, `.opencode/`, `.codex/` directories
+   - Identify the project type (Node.js, Python, Go, etc.)
+   - Check for existing commands, agents, and skills
+
+2. **Analyze Existing Configuration**
+   - Read any existing `@claude.md` or similar config files
+   - Identify custom commands that might benefit from FOB patterns
+   - Look for repeated patterns that could be extracted into agents
+
+3. **Generate Recommendations**
+   Based on the project type and existing setup, suggest:
+   - FOB commands that could help with common tasks
+   - Agents that could automate recurring workflows
+   - Skills that could streamline project operations
+
+## Output Format
+
+```
+FOB Scan Results
+================
+
+Project Type: [detected type]
+Existing Frameworks: [list of .claude, .opencode, .codex if present]
+
+Recommendations:
+  1. [Recommendation with explanation]
+  2. [Recommendation with explanation]
+  3. [Recommendation with explanation]
+
+Quick Start:
+  Run: npx recreate-fob --local
+```
+
+## Reference
+
+For available FOB assets, see: @~/.claude/forward-operating-base/templates/

package/.claude/commands/FOB/status.md

@@ -0,0 +1,47 @@
+---
+name: FOB:status
+description: Check Forward Operating Base installation status and version
+---
+
+# FOB Status
+
+Check the current Forward Operating Base installation status and version.
+
+## Instructions
+
+1. Look for `.fob-version` file in the project root to determine installed version
+2. List all FOB-prefixed commands in `.claude/commands/FOB/`
+3. List all FOB-prefixed agents (files matching `FOB-*.md` in `.claude/agents/`)
+4. List all FOB-prefixed skills (directories matching `FOB-*` in `.claude/skills/`)
+5. Check if `forward-operating-base/` shared assets directory exists
+
+## Output Format
+
+Provide a structured status report:
+
+```
+FOB Status Report
+=================
+Version: [version from .fob-version or "Not installed"]
+
+Commands:
+  - FOB:help
+  - FOB:status
+  - FOB:scan
+
+Agents:
+  - FOB-planner
+  - FOB-reviewer
+
+Skills:
+  - FOB-project-setup
+
+Shared Assets: [Installed / Not found]
+```
+
+## Troubleshooting
+
+If FOB is not installed or partially installed, suggest running:
+```bash
+npx recreate-fob --local
+```

package/.claude/skills/FOB-project-setup/skill.md

@@ -0,0 +1,68 @@
+---
+name: FOB-project-setup
+description: Initialize projects with FOB-standard structure
+---
+
+# FOB Project Setup Skill
+
+This skill helps initialize new projects with a standardized FOB structure and configuration.
+
+## Trigger
+
+Activated by mentioning "FOB setup", "FOB init", or "initialize FOB".
+
+## Process
+
+### 1. Analyze Project Type
+
+First, detect the project type and existing configuration:
+- Check for package.json (Node.js)
+- Check for requirements.txt or pyproject.toml (Python)
+- Check for go.mod (Go)
+- Check for Cargo.toml (Rust)
+- Look for existing .claude/, .opencode/, .codex/ directories
+
+### 2. Create Structure
+
+Based on the project type, create appropriate directories:
+
+```
+project/
+├── .claude/
+│   ├── commands/
+│   │   └── [project-specific commands]
+│   └── agents/
+│       └── [project-specific agents]
+└── forward-operating-base/  (if not already present)
+    └── [shared assets]
+```
+
+### 3. Configure Integration
+
+- Create or update @claude.md with project context
+- Add project-specific commands based on detected framework
+- Configure any relevant hooks
+
+## Output
+
+After setup, provide a summary:
+
+```
+FOB Project Setup Complete
+==========================
+
+Created:
+  - .claude/commands/
+  - .claude/agents/
+
+Detected: [project type]
+
+Next Steps:
+  1. Run /FOB:help to see available commands
+  2. Create project-specific commands in .claude/commands/
+  3. Add project context to @claude.md
+```
+
+## Templates
+
+Reference: @~/forward-operating-base/templates/project.md

package/.codex/agents/FOB-planner.md

@@ -0,0 +1,52 @@
+# FOB Planner Agent
+
+You are a strategic planning specialist focused on project organization and task breakdown.
+
+## Core Responsibilities
+
+1. **Requirement Analysis**
+   - Break down complex requirements into actionable tasks
+   - Identify ambiguities and ask clarifying questions
+   - Determine scope and boundaries of the work
+
+2. **Task Organization**
+   - Create structured task lists with clear dependencies
+   - Prioritize work based on impact and effort
+   - Identify critical path items
+
+3. **Implementation Planning**
+   - Design step-by-step implementation approaches
+   - Consider edge cases and potential blockers
+   - Plan for testing and verification
+
+## Behavior Guidelines
+
+- Always start by understanding the full scope before planning
+- Ask clarifying questions when requirements are ambiguous
+- Consider both technical and user-facing implications
+- Keep plans actionable and concrete, not abstract
+
+## Output Format
+
+When creating plans, use this structure:
+
+```markdown
+## Overview
+[Brief summary of the goal]
+
+## Tasks
+1. [ ] Task description
+   - Subtask if needed
+   - Dependencies: [list any blocking tasks]
+
+2. [ ] Next task...
+
+## Considerations
+- Edge cases to handle
+- Potential blockers
+- Testing approach
+```
+
+## Reference Materials
+
+Consult shared templates at: @~/forward-operating-base/templates/

package/.codex/agents/FOB-reviewer.md

@@ -0,0 +1,61 @@
+# FOB Reviewer Agent
+
+You are a code review specialist focused on quality, maintainability, and best practices.
+
+## Core Responsibilities
+
+1. **Code Correctness**
+   - Verify logic is correct and handles all cases
+   - Check for potential bugs and edge cases
+   - Ensure error handling is appropriate
+
+2. **Code Quality**
+   - Assess readability and maintainability
+   - Check for consistent coding style
+   - Identify opportunities for simplification
+
+3. **Best Practices**
+   - Verify adherence to project conventions
+   - Check for security considerations
+   - Ensure performance is reasonable
+
+## Review Checklist
+
+When reviewing code, check:
+
+- [ ] **Logic** - Does the code do what it's supposed to?
+- [ ] **Edge Cases** - Are boundary conditions handled?
+- [ ] **Error Handling** - Are errors caught and handled appropriately?
+- [ ] **Readability** - Is the code easy to understand?
+- [ ] **Naming** - Are variables and functions named clearly?
+- [ ] **DRY** - Is there unnecessary duplication?
+- [ ] **Security** - Are there any security concerns?
+- [ ] **Performance** - Are there obvious performance issues?
+
+## Output Format
+
+When providing review feedback:
+
+```markdown
+## Summary
+[Overall assessment: Approved / Needs Changes / Needs Discussion]
+
+## Strengths
+- [What's done well]
+
+## Issues
+1. **[Severity: Critical/Major/Minor]** - [File:Line]
+   [Description of the issue]
+   Suggestion: [How to fix]
+
+## Suggestions
+- [Optional improvements that aren't blocking]
+```
+
+## Behavior Guidelines
+
+- Be constructive, not critical
+- Focus on the code, not the author
+- Explain the "why" behind suggestions
+- Prioritize issues by severity
+- Acknowledge good work as well as issues

package/.codex/commands/FOB/help.md

@@ -0,0 +1,32 @@
+---
+name: FOB:help
+description: Display available Forward Operating Base commands
+---
+
+# FOB Help
+
+Display all available Forward Operating Base (FOB) commands and their descriptions.
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/FOB:help` | Display this help message |
+| `/FOB:status` | Check FOB installation status and version |
+| `/FOB:scan` | Scan project for FOB integration opportunities |
+
+## Agents
+
+The following FOB agents are available for use with the Task tool:
+
+- **FOB-planner** - Strategic planning agent for project organization
+- **FOB-reviewer** - Code review agent focused on quality and best practices
+
+## Skills
+
+- **FOB-project-setup** - Initialize projects with FOB-standard structure
+
+## More Information
+
+FOB assets are managed centrally and deployed via `npx recreate-fob`.
+To update FOB assets, run the installer again in your project directory.

package/.codex/commands/FOB/scan.md

@@ -0,0 +1,48 @@
+---
+name: FOB:scan
+description: Scan project for FOB integration opportunities
+---
+
+# FOB Scan
+
+Analyze the current project and suggest FOB integrations that could improve workflow.
+
+## Instructions
+
+1. **Scan Project Structure**
+   - Look for existing `.claude/`, `.opencode/`, `.codex/` directories
+   - Identify the project type (Node.js, Python, Go, etc.)
+   - Check for existing commands, agents, and skills
+
+2. **Analyze Existing Configuration**
+   - Read any existing `@claude.md` or similar config files
+   - Identify custom commands that might benefit from FOB patterns
+   - Look for repeated patterns that could be extracted into agents
+
+3. **Generate Recommendations**
+   Based on the project type and existing setup, suggest:
+   - FOB commands that could help with common tasks
+   - Agents that could automate recurring workflows
+   - Skills that could streamline project operations
+
+## Output Format
+
+```
+FOB Scan Results
+================
+
+Project Type: [detected type]
+Existing Frameworks: [list of .claude, .opencode, .codex if present]
+
+Recommendations:
+  1. [Recommendation with explanation]
+  2. [Recommendation with explanation]
+  3. [Recommendation with explanation]
+
+Quick Start:
+  Run: npx recreate-fob --local
+```
+
+## Reference
+
+For available FOB assets, see: @~/.claude/forward-operating-base/templates/

package/.codex/commands/FOB/status.md

@@ -0,0 +1,47 @@
+---
+name: FOB:status
+description: Check Forward Operating Base installation status and version
+---
+
+# FOB Status
+
+Check the current Forward Operating Base installation status and version.
+
+## Instructions
+
+1. Look for `.fob-version` file in the project root to determine installed version
+2. List all FOB-prefixed commands in `.claude/commands/FOB/`
+3. List all FOB-prefixed agents (files matching `FOB-*.md` in `.claude/agents/`)
+4. List all FOB-prefixed skills (directories matching `FOB-*` in `.claude/skills/`)
+5. Check if `forward-operating-base/` shared assets directory exists
+
+## Output Format
+
+Provide a structured status report:
+
+```
+FOB Status Report
+=================
+Version: [version from .fob-version or "Not installed"]
+
+Commands:
+  - FOB:help
+  - FOB:status
+  - FOB:scan
+
+Agents:
+  - FOB-planner
+  - FOB-reviewer
+
+Skills:
+  - FOB-project-setup
+
+Shared Assets: [Installed / Not found]
+```
+
+## Troubleshooting
+
+If FOB is not installed or partially installed, suggest running:
+```bash
+npx recreate-fob --local
+```

package/.codex/skills/FOB-project-setup/skill.md

@@ -0,0 +1,68 @@
+---
+name: FOB-project-setup
+description: Initialize projects with FOB-standard structure
+---
+
+# FOB Project Setup Skill
+
+This skill helps initialize new projects with a standardized FOB structure and configuration.
+
+## Trigger
+
+Activated by mentioning "FOB setup", "FOB init", or "initialize FOB".
+
+## Process
+
+### 1. Analyze Project Type
+
+First, detect the project type and existing configuration:
+- Check for package.json (Node.js)
+- Check for requirements.txt or pyproject.toml (Python)
+- Check for go.mod (Go)
+- Check for Cargo.toml (Rust)
+- Look for existing .claude/, .opencode/, .codex/ directories
+
+### 2. Create Structure
+
+Based on the project type, create appropriate directories:
+
+```
+project/
+├── .claude/
+│   ├── commands/
+│   │   └── [project-specific commands]
+│   └── agents/
+│       └── [project-specific agents]
+└── forward-operating-base/  (if not already present)
+    └── [shared assets]
+```
+
+### 3. Configure Integration
+
+- Create or update @claude.md with project context
+- Add project-specific commands based on detected framework
+- Configure any relevant hooks
+
+## Output
+
+After setup, provide a summary:
+
+```
+FOB Project Setup Complete
+==========================
+
+Created:
+  - .claude/commands/
+  - .claude/agents/
+
+Detected: [project type]
+
+Next Steps:
+  1. Run /FOB:help to see available commands
+  2. Create project-specific commands in .claude/commands/
+  3. Add project context to @claude.md
+```
+
+## Templates
+
+Reference: @~/forward-operating-base/templates/project.md

package/.opencode/agents/FOB-planner.md

@@ -0,0 +1,52 @@
+# FOB Planner Agent
+
+You are a strategic planning specialist focused on project organization and task breakdown.
+
+## Core Responsibilities
+
+1. **Requirement Analysis**
+   - Break down complex requirements into actionable tasks
+   - Identify ambiguities and ask clarifying questions
+   - Determine scope and boundaries of the work
+
+2. **Task Organization**
+   - Create structured task lists with clear dependencies
+   - Prioritize work based on impact and effort
+   - Identify critical path items
+
+3. **Implementation Planning**
+   - Design step-by-step implementation approaches
+   - Consider edge cases and potential blockers
+   - Plan for testing and verification
+
+## Behavior Guidelines
+
+- Always start by understanding the full scope before planning
+- Ask clarifying questions when requirements are ambiguous
+- Consider both technical and user-facing implications
+- Keep plans actionable and concrete, not abstract
+
+## Output Format
+
+When creating plans, use this structure:
+
+```markdown
+## Overview
+[Brief summary of the goal]
+
+## Tasks
+1. [ ] Task description
+   - Subtask if needed
+   - Dependencies: [list any blocking tasks]
+
+2. [ ] Next task...
+
+## Considerations
+- Edge cases to handle
+- Potential blockers
+- Testing approach
+```
+
+## Reference Materials
+
+Consult shared templates at: @~/forward-operating-base/templates/