1- # Contributing to cursor-cc-plugins
1+ # Contributing to claude-code-harness
22
3- Thank you for your interest in contributing to cursor-cc-plugins ! This document provides guidelines for contributing.
3+ Thank you for your interest in contributing to ** claude-code-harness ** ! This document provides guidelines for contributing.
44
55## How to Contribute
66
77### Reporting Issues
88
9- 1 . Check if the issue already exists in [ GitHub Issues] ( https://github.com/Chachamaru127/cursor-cc-plugins /issues )
9+ 1 . Check if the issue already exists in [ GitHub Issues] ( https://github.com/Chachamaru127/claude-code-harness /issues )
10102 . If not, create a new issue with:
1111 - Clear title describing the problem
1212 - Steps to reproduce
@@ -43,7 +43,7 @@ We follow [Conventional Commits](https://www.conventionalcommits.org/):
4343## Plugin Structure
4444
4545```
46- cursor-cc-plugins /
46+ claude-code-harness /
4747├── .claude-plugin/
4848│ ├── plugin.json # Plugin manifest
4949│ └── marketplace.json # Marketplace config
@@ -67,8 +67,9 @@ cursor-cc-plugins/
6767
68681 . Create ` agents/your-agent.md `
69692 . Define the agent with YAML frontmatter
70- 3 . Add to ` plugin.json ` agents array
71- 4 . Update README.md
70+ 3 . Update README.md (recommended)
71+
72+ > Note: agents/ are auto-discovered by Claude Code. You typically do not need to manually enumerate them in ` plugin.json ` .
7273
7374### Adding a New Skill
7475
@@ -91,30 +92,41 @@ Version is defined in two places that must stay in sync:
9192# Sync plugin.json to VERSION
9293./scripts/sync-version.sh sync
9394
94- # Bump patch version (0.3.1 → 0.3.2 )
95+ # Bump patch version (e.g., 2.0.0 → 2.0.1 )
9596./scripts/sync-version.sh bump
9697```
9798
98- ### Pre-commit Hook
99-
100- A pre-commit hook automatically checks version consistency. If ` VERSION ` or ` plugin.json ` is modified and they don't match, the commit will fail.
99+ ### Version Consistency Checks
101100
102- To fix: ` ./scripts/sync-version.sh sync `
101+ - ** Local (recommended)** : run ` ./scripts/sync-version.sh check ` before committing
102+ - ** CI (recommended)** : run ` ./tests/validate-plugin.sh ` and ` ./scripts/ci/check-consistency.sh ` on PRs
103103
104104---
105105
106106## Testing
107107
108108Before submitting:
109109
110- 1 . Install the plugin locally:
110+ 1 . Validate plugin structure and consistency:
111+
112+ ``` bash
113+ ./tests/validate-plugin.sh
114+ ./scripts/ci/check-consistency.sh
115+ ```
116+
117+ 2 . Test locally in a separate project using ` --plugin-dir ` :
118+
111119 ``` bash
112- /plugin marketplace add . /path/to/cursor-cc-plugins
113- / plugin install cursor-cc-plugins
120+ cd /path/to/your-project
121+ claude -- plugin-dir /path/to/claude-code-harness
114122 ```
115123
116- 2 . Test commands work as expected
117- 3 . Verify no errors in plugin loading
124+ 3 . Verify commands work as expected (` /help ` ), and the core loop runs:
125+
126+ - ` /harness-init `
127+ - ` /plan `
128+ - ` /work `
129+ - ` /harness-review `
118130
119131## Questions?
120132
0 commit comments