Skip to content

Business operating system for Claude Code — 57 skills, 21 agents, smart daemon. Unified inbox (WhatsApp/Email/Slack/Telegram), autonomous PR merge, full-AWS monitoring, revenue (Stripe+RevenueCat), e-commerce (Shopify), marketing (Klaviyo/Meta/GA4), voice (Bland/ElevenLabs), APM (Datadog/NewRelic/OTEL), YOLO mode.

docs: add CONTRIBUTING.md with branch strategy and protection rules

auroracapital2f2344f0f082
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..3ed1075a
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,64 @@
+# Contributing to claude-ops
+
+PRs welcome from anyone. This document covers the branch strategy, protection rules, and PR workflow.
+
+## Branch Strategy
+
+- **`main`** is the only long-lived branch and the default branch.
+- All work happens on **feature branches** (e.g., `fix/setup-gog-url`, `feat/stripe-revenue`).
+- Feature branches are merged into `main` via PR.
+- There is no `dev` branch.
+
+## Branch Protection
+
+`main` is protected by three layers of rulesets (repo-level + org-level):
+
+| Rule | Maintainer | External contributors |
+|---|---|---|
+| Direct push | Allowed | Blocked |
+| Force push | Blocked | Blocked |
+| Delete branch | Blocked | Blocked |
+| Merge PR without approval | Allowed | Requires 1 approval |
+| Unresolved review threads | Allowed | Blocked |
+
+These rules are enforced at both the repository and organization level and cannot be overridden by repository settings alone.
+
+## PR Workflow
+
+### For external contributors
+
+1. Fork the repo
+2. Create a feature branch from `main`
+3. Make your changes
+4. Open a PR targeting `main`
+5. Wait for review and approval from a maintainer
+6. Once approved, a maintainer will merge your PR
+
+### For maintainers
+
+1. Create a feature branch from `main`
+2. Push the branch and open a PR targeting `main`
+3. Resolve any automated review comments (Copilot code review runs on push)
+4. Merge via `gh pr merge --merge --admin`
+
+## Local Development
+
+```bash
+# Clone and run in development mode
+git clone https://github.com/Lifecycle-Innovations-Limited/claude-ops.git
+cd claude-ops
+claude --plugin-dir ./claude-ops/claude-ops
+
+# After making changes, reload without restarting
+/reload-plugins
+```
+
+## Code Review
+
+- Copilot code review runs automatically on every push and may leave review threads.
+- All review threads must be resolved before merge (for non-maintainers).
+- Maintainers can resolve threads and merge without external approval.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](./claude-ops/LICENSE).
diff --git a/README.md b/README.md
index fe9c3c46..497dbf0b 100644
--- a/README.md
+++ b/README.md
@@ -258,7 +258,9 @@ Just [Claude Code](https://claude.ai/code) 1.0+. Everything else is installed au
## Contributing
-PRs welcome. See [`claude-ops/README.md`](./claude-ops/README.md) for detailed documentation on each skill, agent, and integration. Full guides, troubleshooting, and the threat model live on the [wiki](https://github.com/Lifecycle-Innovations-Limited/claude-ops/wiki).
+PRs welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md) for the full guide, branch rules, and PR workflow.
+
+**Branch strategy:** `main` is the only long-lived branch. All work goes through feature branches → PR to `main`. Branch protection is enforced at repo and org level — no direct pushes, no force pushes, no branch deletion.
```bash
# Development mode — load plugin from local directory
@@ -268,6 +270,8 @@ claude --plugin-dir ./claude-ops/claude-ops
/reload-plugins
```
+See [`claude-ops/README.md`](./claude-ops/README.md) for detailed documentation on each skill, agent, and integration. Full guides, troubleshooting, and the threat model live on the [wiki](https://github.com/Lifecycle-Innovations-Limited/claude-ops/wiki).
+
---
## License