Initialize or validate ProjectMaster configuration for the current directory and its subdirectories
Scans directory for ProjectMaster configuration, validates governance health, and offers initialization or fixes.
/plugin marketplace add eternnoir/claude-tool/plugin install projectmaster@claude-toolsWhen the user runs /project-init, perform the following tasks:
Scan the current directory and subdirectories to understand the existing structure:
Check for RULE.md files:
find . -name "RULE.md" -type f
List all RULE.md files found.
Check for milestones.yaml:
find . -name "milestones.yaml" -type f
Check for project directories: Look for typical project directories:
Identify project structure type:
Present findings to the user:
๐ ProjectMaster Configuration Scan
Current directory: {path}
๐ Found:
- RULE.md files: {count} ({locations})
- milestones.yaml: {count} ({locations})
- Project directories: {list}
๐ Assessment:
{One of:}
- โ
ProjectMaster project detected at {path}
- โ ๏ธ AkashicRecords project detected (no ProjectMaster config)
- โน๏ธ No project governance detected
- ๐ Multiple projects detected: {count}
Based on assessment, offer appropriate actions:
โ
ProjectMaster is initialized for this project.
**Configuration**:
- Methodology: {from RULE.md}
- Team size: {from RULE.md}
- Documentation format: {from RULE.md}
**Health check**:
- RULE.md: โ
Present
- milestones.yaml: โ
Present
- README.md: {โ
Present | โ ๏ธ Missing}
- Directory structure: {โ
Complete | โ ๏ธ Missing directories}
Would you like to:
1. Validate governance (check README.md indexes)
2. Update RULE.md configuration
3. View project status (/project-status)
4. No action needed
โน๏ธ This directory has AkashicRecords governance but no ProjectMaster configuration.
Would you like to add ProjectMaster to this project?
This will:
- Add ProjectMaster-specific configuration to RULE.md
- Create milestones.yaml
- Create project management directories (meetings/, sprints/)
- Maintain AkashicRecords compatibility
Proceed with ProjectMaster initialization?
- Yes, initialize ProjectMaster
- No, keep as is
If yes, activate the initialize-project Skill to add ProjectMaster to the existing structure.
โน๏ธ This directory is not initialized for ProjectMaster.
Would you like to initialize project management for this directory?
This will create:
- RULE.md with project governance
- Project directory structure (meetings/, sprints/, docs/)
- milestones.yaml for milestone tracking
- README.md files for navigation
Proceed with initialization?
- Yes, initialize new project
- No, cancel
If yes, activate the initialize-project Skill with guided Q&A.
๐ Multiple projects detected:
1. {path1} - {Project Name or "Unnamed"}
2. {path2} - {Project Name or "Unnamed"}
3. {path3} - {Project Name or "Unnamed"}
Which project would you like to work with?
- Select project: {1-3}
- Initialize new project in current directory
- Validate all projects
- Cancel
Handle user selection and proceed accordingly.
If user chooses to validate governance:
Read RULE.md: Check that all required fields are present:
Check directory structure: Verify that directories specified in RULE.md exist:
ls -ld meetings/ sprints/ docs/ decisions/
Check README.md files: Verify that README.md files exist and are up to date:
Check milestones.yaml: Verify structure and required fields:
project:
name: ...
start_date: ...
milestones:
- id: ...
name: ...
[etc.]
Report validation results:
โ
Governance Validation Report
**RULE.md**: โ
All required fields present
**Directory Structure**: โ
All directories exist
**README.md Indexes**: {status}
- Root: โ
Present, last updated {date}
- meetings/: โ
Present, last updated {date}
- sprints/: โ ๏ธ Outdated (last updated {date}, {count} new items)
- docs/: โ Missing
**milestones.yaml**: โ
Valid structure
Issues found: {count}
Offer fixes:
Would you like to fix issues automatically?
- Yes, fix all issues
- Let me fix manually
If yes:
Carry out the user's selected action:
initialize-project Skill/project-status commandUser: /project-init
Claude: ๐ ProjectMaster Configuration Scan
Current directory: /Users/user/my-project
๐ Found:
- RULE.md files: 0
- milestones.yaml: 0
- Project directories: None
๐ Assessment:
โน๏ธ No project governance detected
Would you like to initialize project management for this directory?
This will create:
- RULE.md with project governance
- Project directory structure
- milestones.yaml
- README.md files
Proceed? [Yes/No]
User: Yes
Claude: Great! Let's set up your project...
[Activates initialize-project Skill with Q&A]
User: /project-init
Claude: ๐ ProjectMaster Configuration Scan
Current directory: /Users/user/ecommerce-redesign
๐ Found:
- RULE.md files: 1 (./RULE.md)
- milestones.yaml: 1 (./milestones.yaml)
- Project directories: meetings/, sprints/, docs/, decisions/
๐ Assessment:
โ
ProjectMaster project detected
**Configuration**:
- Methodology: Scrum (2-week sprints)
- Team size: 6
- Documentation format: Structured with frontmatter
**Health check**:
- RULE.md: โ
Present
- milestones.yaml: โ
Present
- README.md: โ
Present, updated 2025-11-13
- Directory structure: โ
Complete
Would you like to:
1. Validate governance
2. Update RULE.md configuration
3. View project status
4. No action needed
User: 1
Claude: Running governance validation...
โ
Governance Validation Report
All systems healthy! No issues found.
User: /project-init
Claude: [Scans and detects issues]
โ ๏ธ Governance Validation Report
**Issues found**: 3
1. โ ๏ธ meetings/README.md is outdated
- Last updated: 2025-11-01
- 8 new meetings since then
2. โ docs/README.md is missing
- 5 documentation files exist
- No index found
3. โ ๏ธ milestones.yaml has invalid entry
- milestone-3 references non-existent dependency
Would you like to fix these automatically?
User: Yes
Claude: Fixing issues...
โ
Updated meetings/README.md with 8 new entries
โ
Created docs/README.md with index of 5 files
โ ๏ธ milestones.yaml issue requires manual review:
milestone-3 depends on "milestone-x" which doesn't exist.
Please check milestones.yaml and correct the dependency.
2 of 3 issues resolved. 1 requires manual attention.
This command is the entry point for ProjectMaster setup and maintenance. It ensures projects stay healthy and well-governed.