Initial commit
This commit is contained in:
661
skills/project-creator/SKILL.md
Normal file
661
skills/project-creator/SKILL.md
Normal file
@@ -0,0 +1,661 @@
|
||||
---
|
||||
name: project-creator
|
||||
description: |
|
||||
Creates new projects in CCGG Business Operations with all required mechanisms automatically implemented.
|
||||
Ensures PARENT SYSTEM INTEGRATION, operations logging, strategic alignment, and cross-project intelligence are properly configured.
|
||||
Handles both simple projects (standard structure) and complex projects (with coordination hubs and dependency tracking).
|
||||
|
||||
Use for: creating new incubator project, adding sub-project to CCGG, initializing project structure, setting up project coordination, ensuring PARENT SYSTEM INTEGRATION implemented, generating CLAUDE.md with all mechanisms, creating Active Projects Index entry.
|
||||
|
||||
Trigger terms: create project, new project, initialize project, set up project, add sub-project, project structure, CCGG project creation.
|
||||
version: 1.0.0
|
||||
created: 2025-10-29
|
||||
author: Daron Vener
|
||||
repository: https://github.com/DaronVee/ccgg-project-creator-skill
|
||||
---
|
||||
|
||||
# Project Creator for CCGG Business Operations
|
||||
|
||||
## Quick Start
|
||||
|
||||
**What this skill does**: Automatically creates new CCGG Business Operations projects with all required mechanisms pre-implemented (PARENT SYSTEM INTEGRATION, Active Projects Index, operations logging, etc.).
|
||||
|
||||
**Use when**: Creating new incubator project, adding sub-project to CCGG, setting up project structure
|
||||
|
||||
**Prevents**: Forgetting critical mechanisms like PARENT SYSTEM INTEGRATION (the problem that triggered this skill's creation)
|
||||
|
||||
---
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
**Trigger Phrases**:
|
||||
- "Create new project in CCGG Business Operations"
|
||||
- "Initialize new incubator project"
|
||||
- "Set up project structure for [project-name]"
|
||||
- "Add new sub-project to CCGG"
|
||||
|
||||
**Project Types Supported**:
|
||||
1. **Simple Projects** (majority): Research, single-purpose tools, straightforward deliverables
|
||||
2. **Complex Projects** (strategic): Multi-project coordination, dependencies, integration requirements
|
||||
|
||||
---
|
||||
|
||||
## Project Creation Workflow
|
||||
|
||||
### Step 1: Gather Project Information
|
||||
|
||||
**Ask Daron These Questions** (in conversational order):
|
||||
|
||||
1. **"What's the project name?"**
|
||||
- Format: hyphen-case (e.g., `member-retention-sequences`)
|
||||
- Max 40 characters
|
||||
- Will be used for folder name and project ID
|
||||
|
||||
2. **"What's the project purpose?"** (1-2 sentences)
|
||||
- Clear problem statement
|
||||
- Expected outcome
|
||||
- Example: "Design email sequences to re-engage churned members and improve retention rate"
|
||||
|
||||
3. **Analyze project description for multi-phase indicators** (SUGGESTION, not question):
|
||||
|
||||
**Claude analyzes** project purpose and deliverables for signals:
|
||||
- Keywords: "validate", "test", "feedback", "iterate", "production rollout", "pilot"
|
||||
- Complex deliverables (3+ major components requiring testing)
|
||||
- Integration with existing systems (needs testing phase)
|
||||
- User mentions "experiment", "trial", or "phase"
|
||||
- Project type: infrastructure, framework, new system (vs simple content creation)
|
||||
|
||||
**If multi-phase indicators detected**, SUGGEST phased approach:
|
||||
```
|
||||
"Based on your project description, I recommend a multi-phase approach:
|
||||
|
||||
Phase 1: [Research & Planning / Setup & Test / MVP]
|
||||
Phase 2: [Build & Test / Validation & Refinement / Production Rollout]
|
||||
Phase 3: [Deploy & Scale / Institutionalize / Maintenance]
|
||||
|
||||
This allows testing and feedback before full rollout. Would you like to use this phased approach?"
|
||||
```
|
||||
|
||||
**User can respond**:
|
||||
- "Yes, use phases" → Generate PHASE_TRACKER.md with suggested phases
|
||||
- "No, single phase" → Skip Phase Tracker
|
||||
- "Let me customize phases" → Ask for phase names/durations
|
||||
|
||||
**If NO multi-phase indicators**, skip suggestion and Phase Tracker
|
||||
|
||||
4. **"Will this project coordinate with or depend on other projects?"**
|
||||
- If YES → Complex project (needs Coordination Hub)
|
||||
- If NO → Simple project (standard structure only)
|
||||
|
||||
5. **ALWAYS: Detect and Capture Dependencies** (NEW - Forcing Function)
|
||||
|
||||
**Claude PROACTIVELY suggests dependencies** based on project description:
|
||||
|
||||
```
|
||||
"Let me help identify dependencies for this project:
|
||||
|
||||
BLOCKING DEPENDENCIES (must complete before starting this):
|
||||
- What existing work must finish before you can start?
|
||||
- What deliverables from other projects do you need?
|
||||
|
||||
DOWNSTREAM DEPENDENCIES (projects waiting for this):
|
||||
- What other projects are waiting for this one?
|
||||
- What will this project enable or unblock?
|
||||
|
||||
RELATED PARALLEL (connected but not blocking):
|
||||
- What other projects share themes/tools with this?
|
||||
|
||||
[Based on your project description, I see potential dependencies:]
|
||||
- [Suggest upstream based on keywords/deliverables mentioned]
|
||||
- [Suggest downstream based on Active Projects needing this work]
|
||||
|
||||
Should I add these to the dependency metadata?"
|
||||
```
|
||||
|
||||
**Capture in YAML format**:
|
||||
```yaml
|
||||
dependencies:
|
||||
blocks: ["project-id-1", "project-id-2"] # Must complete first
|
||||
blocked_by: ["project-id-3"] # Waiting for this
|
||||
related_parallel: ["project-id-4"] # Connected, not blocking
|
||||
```
|
||||
|
||||
**Even if "none"**, still create empty fields (forces conscious decision):
|
||||
```yaml
|
||||
dependencies:
|
||||
blocks: [] # No upstream dependencies
|
||||
blocked_by: [] # No downstream dependencies
|
||||
related_parallel: [] # No related work
|
||||
```
|
||||
|
||||
6. **If Complex: "Which projects does this coordinate with?"**
|
||||
- Upstream dependencies (what this project needs)
|
||||
- Downstream dependencies (what other projects need from this)
|
||||
- Example: "Depends on hormozi-money-models (frameworks), feeds into retention-reengagement (implementation)"
|
||||
- **NOTE**: This is for Coordination Hub documentation (prose), Step 5 captures YAML metadata
|
||||
|
||||
7. **"What are the key deliverables?"** (3-5 items)
|
||||
- Specific outputs this project will produce
|
||||
- Example: "Email sequence templates, DM scripts, retention playbook"
|
||||
|
||||
8. **"Which avatars does this serve?"** (optional, for strategic alignment)
|
||||
- From Target_Avatars_Complete_Profiles.md
|
||||
- If "all avatars" → note that
|
||||
- If specific → list them
|
||||
|
||||
---
|
||||
|
||||
### Step 2: Determine Project Complexity
|
||||
|
||||
**Based on Question 3 answer**:
|
||||
|
||||
**SIMPLE PROJECT** (if NO coordination):
|
||||
- Standard folder structure
|
||||
- CLAUDE.md with PARENT SYSTEM INTEGRATION
|
||||
- README.md
|
||||
- Active Projects Index
|
||||
- operations_log entry
|
||||
|
||||
**COMPLEX PROJECT** (if YES coordination):
|
||||
- All simple project components PLUS:
|
||||
- Coordination Hub/ folder
|
||||
- PROJECT_DEPENDENCIES.md
|
||||
- INTEGRATION_CHECKLIST.md
|
||||
- OUTPUT_LIBRARY.md
|
||||
- Enhanced CLAUDE.md (cross-project knowledge access patterns)
|
||||
- Integration sections in related projects' CLAUDE.md files
|
||||
|
||||
---
|
||||
|
||||
### Step 3: Create Project Structure
|
||||
|
||||
**Location**: `Active Projects/_Incubator/[project-name]/`
|
||||
|
||||
**Manual Creation** (automated script planned for future):
|
||||
1. Create folder: `mkdir "Active Projects/_Incubator/[project-name]"`
|
||||
2. Use Write tool to create CLAUDE.md from `templates/CLAUDE_SIMPLE.md` OR `templates/CLAUDE_COMPLEX.md`
|
||||
3. **If multi-phase project**: Use Write tool to create PHASE_TRACKER.md from `templates/PHASE_TRACKER_TEMPLATE.md`
|
||||
4. Fill all placeholders (marked with `{{VARIABLE}}`)
|
||||
|
||||
This creates:
|
||||
```
|
||||
[project-name]/
|
||||
├── CLAUDE.md # Project guidance (PARENT SYSTEM INTEGRATION included)
|
||||
├── README.md # Quick start + overview
|
||||
├── [folders based on project type]
|
||||
└── Coordination Hub/ # If complex project
|
||||
├── PROJECT_DEPENDENCIES.md
|
||||
├── INTEGRATION_CHECKLIST.md
|
||||
└── OUTPUT_LIBRARY.md
|
||||
```
|
||||
|
||||
**Note**: Full automation script (`create_project.sh`) is planned but not yet implemented. Current workflow uses templates + manual variable replacement.
|
||||
|
||||
---
|
||||
|
||||
### Step 4: Generate CLAUDE.md Content
|
||||
|
||||
**Use Template**:
|
||||
- Simple: `templates/CLAUDE_SIMPLE.md`
|
||||
- Complex: `templates/CLAUDE_COMPLEX.md`
|
||||
|
||||
**Required Sections** (ALL projects):
|
||||
1. **PROJECT IDENTITY** (name, type, status, created date, owner)
|
||||
2. **PROJECT MISSION** (purpose, core focus, expected outcomes)
|
||||
3. **SCOPE & BOUNDARIES** (in scope, out of scope)
|
||||
4. **PARENT SYSTEM INTEGRATION** ⚠️ CRITICAL
|
||||
- Project Memory Index Sync (path, when/how to update)
|
||||
- Operations Logging (format, actions to auto-log, examples)
|
||||
- Strategic Alignment Validation (OOBG check, UV check, Avatar targeting)
|
||||
- Cross-Project Intelligence (search related projects)
|
||||
5. **PROJECT STRUCTURE** (folder organization, key files)
|
||||
6. **EXPECTED DELIVERABLES** (phased if applicable)
|
||||
7. **SUCCESS CRITERIA** (how to measure completion)
|
||||
|
||||
**Additional Sections** (Complex projects):
|
||||
8. **AUTONOMOUS KNOWLEDGE ACCESS** (cross-project references, access commands)
|
||||
9. **COORDINATION WITH OTHER PROJECTS** (dependency chain, integration points)
|
||||
|
||||
**Populate Variables**:
|
||||
- Replace `{{PROJECT_NAME}}` with actual name
|
||||
- Replace `{{PROJECT_PURPOSE}}` with purpose from Step 1
|
||||
- Replace `{{DELIVERABLES}}` with list from Step 1
|
||||
- Replace `{{UPSTREAM_DEPS}}` and `{{DOWNSTREAM_DEPS}}` with projects from Step 1 (if complex)
|
||||
- Replace `{{AVATARS}}` with avatars from Step 1
|
||||
- Add current date in `{{CREATED_DATE}}`
|
||||
- Replace `{{PHASE_TRACKER_SECTION}}` with:
|
||||
- If multi-phase: "**This is a multi-phase project**. See `PHASE_TRACKER.md` for phase timeline, completion criteria, and proactive reminders.\n\n**Current Phase**: [Phase 1 name]\n**Next Milestone**: [Phase 1 completion]\n\n**Manual Check**: Say 'Check phase tracker' anytime for status update."
|
||||
- If single-phase: "**This is a single-phase project**. No phase tracker needed."
|
||||
|
||||
---
|
||||
|
||||
### Step 5: Generate README.md Content
|
||||
|
||||
**Use Template**: `templates/README.md`
|
||||
|
||||
**Required Sections**:
|
||||
1. **Project Title + Overview** (1 paragraph)
|
||||
2. **Quick Start** (how to begin working on this project)
|
||||
3. **Context** (why this project exists, what problem it solves)
|
||||
4. **Key Deliverables** (checklist format)
|
||||
5. **Related Projects** (if complex project)
|
||||
6. **Timeline** (if applicable)
|
||||
7. **Success Criteria**
|
||||
|
||||
**Keep it Concise**: Max 200 lines. README is for quick orientation, CLAUDE.md has details.
|
||||
|
||||
---
|
||||
|
||||
### Step 6: Generate PHASE_TRACKER.md (If Multi-Phase Project)
|
||||
|
||||
**Skip This Step If**: Single-phase project (no phases suggested/accepted in Step 1)
|
||||
|
||||
**If Multi-Phase Project**:
|
||||
|
||||
**Location**: `Active Projects/_Incubator/[project-name]/PHASE_TRACKER.md`
|
||||
|
||||
**Use Template**: `templates/PHASE_TRACKER_TEMPLATE.md`
|
||||
|
||||
**Populate Variables**:
|
||||
- `{{PROJECT_NAME}}`, `{{PROJECT_TITLE}}`, `{{CREATED_DATE}}` - From Step 1
|
||||
- For each phase (1-3):
|
||||
- `{{PHASE_N_NAME}}` - Phase name (e.g., "Setup & Test", "Validation & Refinement")
|
||||
- `{{PHASE_N_GOAL}}` - What this phase accomplishes
|
||||
- `{{PHASE_N_DURATION}}` - Time estimate (e.g., "4 weeks", "1 week")
|
||||
- `{{PHASE_N_TARGET_DATES}}` - Date range (calculate from project start + duration)
|
||||
- `{{PHASE_N_CRITERIA}}` - Completion criteria (suggest based on deliverables)
|
||||
- `{{PHASE_N_DELIVERABLES}}` - Phase-specific deliverables checklist
|
||||
- `{{PHASE_N_REMINDER_LOGIC}}` - How Claude checks weekly
|
||||
- `{{PHASE_N_TRANSITION_TRIGGER}}` - When to prompt next phase
|
||||
- `{{PHASE_N_NEXT_TRIGGER}}` - Date or criteria
|
||||
- `{{PHASE_N_CHECK_LOGIC}}` - How to validate completion
|
||||
- `{{PHASE_N_SUCCESS_INDICATORS}}` - What signals success
|
||||
- `{{PHASE_N_SUCCESS_DEFINITION}}` - Overall phase success
|
||||
- `{{PROJECT_COMPLETION_DEFINITION}}` - What "project complete" means
|
||||
- `{{OVERALL_SUCCESS_DEFINITION}}` - Final success definition
|
||||
- `{{NEXT_CHECK_DATE}}` - Calculate (project start + 1 week)
|
||||
|
||||
**Default Phase Structure** (if user accepts suggestion):
|
||||
|
||||
**Phase 1**: Setup & Test / MVP / Research & Planning (2-4 weeks)
|
||||
- Goal: Create system, test basic functionality, validate approach
|
||||
- Criteria: Core deliverables complete, basic testing done
|
||||
|
||||
**Phase 2**: Validation & Refinement / Production Rollout / Build & Test (1-2 weeks)
|
||||
- Goal: Review Phase 1 results, refine approach, confirm effectiveness
|
||||
- Criteria: Patterns identified, template/system refined, frequency/scope confirmed
|
||||
|
||||
**Phase 3**: Institutionalize / Scale / Deploy (1 week)
|
||||
- Goal: Promote to production, document final workflow, mark production-ready
|
||||
- Criteria: Integrated into root CLAUDE.md, added to registries, sustainable
|
||||
|
||||
**Proactive Reminder Example**:
|
||||
```
|
||||
Phase 1 Reminder Logic:
|
||||
- Weekly: Check if [X weeks] passed OR [N deliverables] complete
|
||||
- Transition: After [criteria met] OR [deadline] → "Ready for Phase 2?"
|
||||
|
||||
Phase 2 Reminder Logic:
|
||||
- After Phase 1 complete → Prompt immediately
|
||||
- After Phase 2 tasks done → "Ready for Phase 3?"
|
||||
|
||||
Phase 3 Reminder Logic:
|
||||
- After Phase 2 complete → Prompt immediately
|
||||
- After Phase 3 tasks done → "Project complete!"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Step 7: Create Active Projects Index Entry
|
||||
|
||||
**Location**: `Project Memory/Active Projects Index/[project-name]-index.md`
|
||||
|
||||
**Use Template**: `templates/PROJECT_INDEX.md`
|
||||
|
||||
**Required Content** (YAML frontmatter + sections):
|
||||
```yaml
|
||||
---
|
||||
project_id: "incubator-[project-name]"
|
||||
title: "[Project Title]"
|
||||
project_type: "incubator-program"
|
||||
status: "incubating"
|
||||
date_created: "YYYY-MM-DD"
|
||||
date_modified: "YYYY-MM-DD"
|
||||
folder_path: "Active Projects/_Incubator/[project-name]"
|
||||
tags: ["tag1", "tag2", "tag3"]
|
||||
strategic_alignment:
|
||||
oobg_relevance: "[How this serves OOBG]"
|
||||
unique_vehicle_fit: "[How this leverages YouTube + CCGG community]"
|
||||
avatar_targets: ["Avatar1", "Avatar2"]
|
||||
|
||||
# NEW: Dependency tracking (from Step 5)
|
||||
dependencies:
|
||||
blocks: [] # Projects that BLOCK this one (must complete first)
|
||||
blocked_by: [] # Projects this one BLOCKS (waiting for this)
|
||||
related_parallel: [] # Connected but not blocking
|
||||
|
||||
dependency_status:
|
||||
is_blocked: false # Auto-calculated from blocks[]
|
||||
blocking_count: 0 # Auto-calculated from blocked_by[]
|
||||
ready_to_start: true # Auto-calculated
|
||||
|
||||
last_sync: "YYYY-MM-DD (Project creation)"
|
||||
---
|
||||
|
||||
## Current Status
|
||||
[Project status description]
|
||||
|
||||
## Key Deliverables
|
||||
[Checklist of deliverables]
|
||||
|
||||
## Last Activity
|
||||
[Most recent work]
|
||||
|
||||
## Quick Access
|
||||
[Links to project folder and key files]
|
||||
```
|
||||
|
||||
**Populate with Data from Step 1**
|
||||
|
||||
---
|
||||
|
||||
### Step 7: Create Coordination Hub (Complex Projects Only)
|
||||
|
||||
**If Simple Project**: Skip this step.
|
||||
|
||||
**If Complex Project**: Create 3 coordination files:
|
||||
|
||||
#### PROJECT_DEPENDENCIES.md
|
||||
**Purpose**: Track what this project needs from/provides to other projects
|
||||
|
||||
**Use Template**: `templates/coordination/PROJECT_DEPENDENCIES.md`
|
||||
|
||||
**Populate**:
|
||||
- Upstream dependencies (projects this depends on)
|
||||
- Downstream dependencies (projects that depend on this)
|
||||
- Integration checkpoints
|
||||
- Blocker tracking section
|
||||
|
||||
#### INTEGRATION_CHECKLIST.md
|
||||
**Purpose**: Ensure all dependencies met before execution/handoff
|
||||
|
||||
**Use Template**: `templates/coordination/INTEGRATION_CHECKLIST.md`
|
||||
|
||||
**Populate**:
|
||||
- Pre-requisites from upstream projects
|
||||
- Execution checklist (this project's phases)
|
||||
- Post-implementation checklist (handoffs to downstream)
|
||||
- Validation criteria
|
||||
|
||||
#### OUTPUT_LIBRARY.md
|
||||
**Purpose**: Catalog deliverables for other projects to reference
|
||||
|
||||
**Use Template**: `templates/coordination/OUTPUT_LIBRARY.md`
|
||||
|
||||
**Populate**:
|
||||
- List expected outputs with status (PENDING/IN PROGRESS/COMPLETE)
|
||||
- Link to files when created
|
||||
- Note which projects consume each output
|
||||
|
||||
---
|
||||
|
||||
### Step 8: Log Project Creation
|
||||
|
||||
**Auto-log to operations_log.txt**:
|
||||
|
||||
```
|
||||
[YYYY-MM-DD HH:MM:SS] - CREATE - [project-name] - New incubator project created. [Simple/Complex] structure. [Key context]. Deliverables: [list]. Dependencies: [if complex].
|
||||
```
|
||||
|
||||
**Example**:
|
||||
```
|
||||
[2025-10-29 14:30:00] - CREATE - member-retention-sequences - New incubator project created. Simple structure. Email sequences to re-engage churned members. Deliverables: 5 email templates, 3 DM scripts, retention playbook.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Step 9: Validate All Mechanisms Implemented
|
||||
|
||||
**Run Checklist** (automated validation):
|
||||
|
||||
```bash
|
||||
bash scripts/validate_project.sh [project-name]
|
||||
```
|
||||
|
||||
**Manual Checklist** (if script unavailable):
|
||||
- [ ] CLAUDE.md exists with PARENT SYSTEM INTEGRATION section
|
||||
- [ ] PARENT SYSTEM INTEGRATION has all 4 sub-sections:
|
||||
- [ ] Project Memory Index Sync
|
||||
- [ ] Operations Logging
|
||||
- [ ] Strategic Alignment Validation
|
||||
- [ ] Cross-Project Intelligence
|
||||
- [ ] CLAUDE.md has MULTI-PHASE PROJECT TRACKER section with appropriate text
|
||||
- [ ] README.md exists with Quick Start section
|
||||
- [ ] Active Projects Index entry created
|
||||
- [ ] operations_log.txt entry added
|
||||
- [ ] Folder structure matches project complexity (simple vs complex)
|
||||
- [ ] If complex: Coordination Hub created with 3 files
|
||||
- [ ] If multi-phase: PHASE_TRACKER.md created and populated
|
||||
- [ ] All template variables replaced (no `{{PLACEHOLDER}}` remaining)
|
||||
|
||||
**If any checks fail**: Fix before proceeding.
|
||||
|
||||
---
|
||||
|
||||
### Step 10: Report Completion
|
||||
|
||||
**Generate Summary Report**:
|
||||
|
||||
```
|
||||
✅ Project Created: [project-name]
|
||||
|
||||
**Location**: Active Projects/_Incubator/[project-name]/
|
||||
**Complexity**: [Simple/Complex]
|
||||
**Multi-Phase**: [Yes (3 phases) / No (single-phase)]
|
||||
**Purpose**: [One-sentence purpose]
|
||||
|
||||
**Files Created**:
|
||||
- CLAUDE.md (with PARENT SYSTEM INTEGRATION ✓)
|
||||
- README.md
|
||||
- [If multi-phase] PHASE_TRACKER.md (Phase 1: [name], Phase 2: [name], Phase 3: [name])
|
||||
- [List other files/folders]
|
||||
|
||||
**Index Entry**: Project Memory/Active Projects Index/[project-name]-index.md ✓
|
||||
**Operations Log**: Logged at [timestamp] ✓
|
||||
|
||||
**Phase Tracker** (if multi-phase):
|
||||
- Current Phase: Phase 1 ([name])
|
||||
- Next Check: [date] (weekly during strategic planning)
|
||||
- Manual Check: Say "Check phase tracker [project-name]" anytime
|
||||
|
||||
**Next Steps**:
|
||||
1. Review CLAUDE.md for project-specific guidance
|
||||
2. [If multi-phase] Review PHASE_TRACKER.md for phase timeline
|
||||
3. Begin work on first deliverable: [first item from Step 1]
|
||||
4. Update index after major progress
|
||||
|
||||
**Quick Access**: [Link to project folder]
|
||||
```
|
||||
|
||||
**Present to Daron** for confirmation before moving on.
|
||||
|
||||
---
|
||||
|
||||
## Templates Reference
|
||||
|
||||
All templates are in `templates/` folder:
|
||||
|
||||
**Core Templates**:
|
||||
- `CLAUDE_SIMPLE.md` - Standard project CLAUDE.md (with PARENT SYSTEM INTEGRATION)
|
||||
- `CLAUDE_COMPLEX.md` - Complex project CLAUDE.md (adds cross-project coordination)
|
||||
- `README.md` - Standard README structure
|
||||
- `PROJECT_INDEX.md` - Active Projects Index entry template
|
||||
|
||||
**Coordination Templates** (complex projects only):
|
||||
- `coordination/PROJECT_DEPENDENCIES.md`
|
||||
- `coordination/INTEGRATION_CHECKLIST.md`
|
||||
- `coordination/OUTPUT_LIBRARY.md`
|
||||
|
||||
**See**: [templates/README.md](templates/README.md) for template usage guide
|
||||
|
||||
---
|
||||
|
||||
## Scripts Reference
|
||||
|
||||
**create_project.sh** - Automates project structure creation
|
||||
```bash
|
||||
bash scripts/create_project.sh [project-name] [simple|complex]
|
||||
```
|
||||
|
||||
**validate_project.sh** - Validates all mechanisms implemented
|
||||
```bash
|
||||
bash scripts/validate_project.sh [project-name]
|
||||
```
|
||||
|
||||
**See**: [scripts/README.md](scripts/README.md) for script documentation
|
||||
|
||||
---
|
||||
|
||||
## Common Scenarios
|
||||
|
||||
### Scenario 1: Simple Research Project
|
||||
**Example**: "Create project to research Dream 100 strategies"
|
||||
|
||||
**Workflow**:
|
||||
1. Name: `dream-100-research`
|
||||
2. Purpose: "Research and document Dream 100 implementation strategies for CCGG traffic growth"
|
||||
3. Coordination: NO (simple project)
|
||||
4. Deliverables: Research document, implementation plan, resource list
|
||||
5. Avatars: All (traffic benefits everyone)
|
||||
6. Create → Simple structure
|
||||
7. Validate → Done
|
||||
|
||||
**Time**: 10-15 minutes
|
||||
|
||||
---
|
||||
|
||||
### Scenario 2: Complex Strategic Project
|
||||
**Example**: "Create project for CCGG offers and pricing strategy"
|
||||
|
||||
**Workflow**:
|
||||
1. Name: `ccgg-offers-pricing`
|
||||
2. Purpose: "Design CCGG pricing structure and offer ladder to maximize revenue per customer"
|
||||
3. Coordination: YES
|
||||
- Depends on: hormozi-money-models (frameworks), claude-code-business-os (offer ladder)
|
||||
- Feeds into: member-onboarding-ascension (upgrade sequences), retention-reengagement (win-back pricing)
|
||||
4. Deliverables: Tier definitions, pricing structure, implementation plan, annual member presentation
|
||||
5. Avatars: All avatars
|
||||
6. Create → Complex structure (with Coordination Hub)
|
||||
7. Populate dependency maps
|
||||
8. Validate → Done
|
||||
|
||||
**Time**: 20-30 minutes
|
||||
|
||||
---
|
||||
|
||||
## Validation Failures & Fixes
|
||||
|
||||
**Problem**: "PARENT SYSTEM INTEGRATION section missing"
|
||||
**Fix**: Add section from `templates/CLAUDE_SIMPLE.md` lines 40-120
|
||||
|
||||
**Problem**: "Template variables not replaced ({{PROJECT_NAME}} still present)"
|
||||
**Fix**: Search for `{{` and replace all placeholders with actual values
|
||||
|
||||
**Problem**: "Operations log entry missing"
|
||||
**Fix**: Add entry manually:
|
||||
```
|
||||
echo "[$(date +%Y-%m-%d\ %H:%M:%S)] - CREATE - [project-name] - [description]" >> "operations_log.txt"
|
||||
```
|
||||
|
||||
**Problem**: "Active Projects Index missing strategic_alignment section"
|
||||
**Fix**: Add to YAML frontmatter:
|
||||
```yaml
|
||||
strategic_alignment:
|
||||
oobg_relevance: "[description]"
|
||||
unique_vehicle_fit: "[description]"
|
||||
avatar_targets: ["avatar1"]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Important Notes
|
||||
|
||||
### On PARENT SYSTEM INTEGRATION
|
||||
⚠️ **CRITICAL**: This section is **REQUIRED** in every project CLAUDE.md. It is the integration point with CCGG Business Operations.
|
||||
|
||||
**Why it matters**:
|
||||
- Enables automatic operations logging
|
||||
- Keeps Project Memory Index in sync
|
||||
- Validates strategic alignment
|
||||
- Enables cross-project intelligence
|
||||
|
||||
**If forgotten**: Project will be orphaned from CCGG Business Operations system.
|
||||
|
||||
### On Complexity Assessment
|
||||
**Default to Simple** unless clear multi-project coordination is needed.
|
||||
|
||||
**Indicators of Complex Project**:
|
||||
- Depends on outputs from 2+ other projects
|
||||
- 2+ other projects depend on this project's outputs
|
||||
- Strategic planning (affects multiple business areas)
|
||||
- Integration/coordination is core to the project
|
||||
|
||||
**Indicators of Simple Project**:
|
||||
- Self-contained work
|
||||
- Standalone deliverables
|
||||
- No handoffs to other projects required
|
||||
- Research or single-purpose tool
|
||||
|
||||
**When in doubt**: Ask Daron, "Will this project need to coordinate with other active projects?"
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria
|
||||
|
||||
**Project creation is successful when**:
|
||||
1. All validation checks pass (Step 9)
|
||||
2. Daron can open the project and immediately understand:
|
||||
- What it does
|
||||
- What mechanisms are available
|
||||
- How to get started
|
||||
3. PARENT SYSTEM INTEGRATION is fully implemented
|
||||
4. Future Claude sessions can find this project via Active Projects Index search
|
||||
|
||||
**Project creation has FAILED if**:
|
||||
- Any mechanism is missing (especially PARENT SYSTEM INTEGRATION)
|
||||
- Template variables not replaced
|
||||
- Daron has to manually add standard components
|
||||
- Operations log entry missing
|
||||
|
||||
---
|
||||
|
||||
## Additional Resources
|
||||
|
||||
**For detailed mechanism specifications**, see:
|
||||
- [references/mechanism_specifications.md](references/mechanism_specifications.md) - Complete templates, variable replacement guide, and mechanism requirements
|
||||
|
||||
**For template usage**, see:
|
||||
- [templates/README.md](templates/README.md) - Template selection guide and variable documentation
|
||||
- [templates/CLAUDE_SIMPLE.md](templates/CLAUDE_SIMPLE.md) - Standard project template
|
||||
- templates/CLAUDE_COMPLEX.md - Complex project template (planned for future - use SIMPLE template + Coordination Hub for now)
|
||||
|
||||
**For validation scripts**, see:
|
||||
- [scripts/README.md](scripts/README.md) - Script documentation and usage examples
|
||||
- [scripts/validate_project.py](scripts/validate_project.py) - Python validation script (recommended)
|
||||
- [scripts/validate_project.sh](scripts/validate_project.sh) - Bash validation script (legacy)
|
||||
|
||||
---
|
||||
|
||||
## Version History
|
||||
|
||||
**v1.0.0** (2025-10-29)
|
||||
- Initial release
|
||||
- Simple and complex project support
|
||||
- Full PARENT SYSTEM INTEGRATION enforcement
|
||||
- Automated validation with Python script
|
||||
- Coordination Hub for complex projects
|
||||
- Progressive disclosure via references/
|
||||
|
||||
---
|
||||
|
||||
**Created with Skills Factory** - Ensures every CCGG Business Operations project is created correctly
|
||||
Reference in New Issue
Block a user