Initial commit

This commit is contained in:
Zhongwei Li
2025-11-29 18:17:39 +08:00
commit 1b8e4d76ac
13 changed files with 2026 additions and 0 deletions

View 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