diff --git a/.claude/skills/icc-setup b/.claude/skills/icc-setup deleted file mode 120000 index be45be31..00000000 --- a/.claude/skills/icc-setup +++ /dev/null @@ -1 +0,0 @@ -../../src/skills/icc-setup \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index cc1dedce..b8aee641 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [10.2.1] - 2026-02-08 + +### Fixed +- Remove broken `.claude/skills/icc-setup` symlink from `main` release branch. + +## [10.2.0] - 2026-02-08 + +### Added +- Dev-first workflow enforcement in skills (all changes go to dev first, main is stable releases only) +- Phase 4: Release (dev → main) in process skill +- PR target branch rules in commit-pr skill (defaults to dev) +- Branch hierarchy documentation in branch-protection skill + +### Changed +- Renamed ansible role `mcp-integration` to `mcp_integration` (ansible-lint compliance) +- Updated version examples from v1.2.0 to v10.x.y in skill documentation +- Fixed fragile `git log dev..HEAD` to use `origin/dev` reference + +### Fixed +- ansible-lint role-name rule violation (hyphens not allowed in role names) +- Non-existent `git.integration_branch` config reference removed +- Removed broken icc-setup symlink from .claude/skills/ + ## [10.1.0] - 2026-02-07 ### Added diff --git a/README.md b/README.md index 51960260..0d0ceb9c 100644 --- a/README.md +++ b/README.md @@ -1,56 +1,62 @@ # Intelligent Claude Code -CC‑native framework for role-based specialists, work queue management, and minimal hooks. +CC-native framework for role-based specialists, cross-agent work tracking, and minimal enforcement hooks. -## Current scope (v10.1) +## What You Get (v10.2.x) -- **Skills-first architecture** — 35 cross-platform skills loaded on demand. -- **CC‑native subagents** — no marker files, no custom role enforcement hooks. -- **Work queue management** — cross-platform task tracking in `.agent/queue/`. -- **Minimal hooks only** — keep only what CC doesn't do natively. -- **Behavior guidance** — 4 foundational behaviors for structural rules. +- **Skills-first architecture**: 35 cross-platform skills loaded on demand. +- **Role-based specialists**: 14 core roles plus dynamic specialists when needed. +- **Work queue**: file-based tracking in `.agent/queue/` for cross-agent compatibility. +- **Minimal hooks**: keep only what Claude Code does not do natively (safety + file routing). +- **Behavior guidance**: a small set of foundational behaviors for structural rules. -## Included +## 60-Second Quickstart -- **14 core roles** + **dynamic specialists** -- **Reviewer role** (critical risk/regression review) -- **Work queue templates** (`.agent/queue/` for cross-platform tracking) -- **Hooks (PreToolUse only)**: - - `agent-infrastructure-protection.js` — block imperative infra changes - - `summary-file-enforcement.js` — route summaries/reports + block ALL‑CAPS filenames +```bash +git clone https://github.com/intelligentcode-ai/intelligent-claude-code.git +cd intelligent-claude-code +make install # or .\\install.ps1 install on Windows +``` -## Removed +In Claude Code, start work via roles: -- Marker‑based orchestration -- Role enforcement hooks -- Reminder hooks -- Auto‑trigger and workflow hooks -- Redundant behavior trees +```text +@PM break down: "Fix the install regression" +@Developer implement the fix +@Reviewer review for regressions +``` + +For larger work, ICC uses a work queue under `.agent/queue/` so tasks stay portable across agents/tools. -## Principles +## Minimal Hooks (Enforcement) -1. **Plan first** → create AgentTask before implementation. -2. **Subagents do the work** → main scope coordinates only. -3. **Keep files tidy** → summaries in `summaries/`, memory in `memory/`. -4. **Protect git** → strip AI mentions when privacy is enabled. -5. **Use CC’s native agent system** → don’t re‑implement it. +Hooks are intentionally minimal (PreToolUse only): +- `agent-infrastructure-protection.js`: blocks dangerous imperative infra operations unless explicitly requested. +- `summary-file-enforcement.js`: routes summaries/reports into `summaries/` and blocks unexpected ALL-CAPS filenames. -## Core roles +## Key Principles -@PM, @Architect, @Developer, @System‑Engineer, @DevOps‑Engineer, @Database‑Engineer, -@Security‑Engineer, @AI‑Engineer, @Web‑Designer, @QA‑Engineer, @Backend‑Tester, -@Requirements‑Engineer, @User‑Role, @Reviewer — plus dynamic specialists (e.g., @React‑Developer). +1. Plan first: break work into small, explicit items. +2. Specialists do the work: the coordinator delegates; roles implement/review/test. +3. Keep outputs tidy: summaries in `summaries/`, memory in `memory/`, stories in `stories/`, bugs in `bugs/`. +4. Guard git hygiene: privacy and branch-protection rules keep commits/PRs clean. +5. Use native agent systems: do not reinvent what your tool already provides. ## Install ```bash -git clone https://github.com/intelligentcode-ai/intelligent-claude-code.git -cd intelligent-claude-code make install # or .\install.ps1 install on Windows make clean-install # force uninstall + reinstall (Linux/macOS) ``` -Usage: +## Core Roles + +`@PM`, `@Architect`, `@Developer`, `@Reviewer`, `@Security-Engineer`, `@QA-Engineer`, `@DevOps-Engineer`, `@Database-Engineer`, +`@System-Engineer`, `@AI-Engineer`, `@Web-Designer`, `@Backend-Tester`, `@Requirements-Engineer`, `@User-Tester`. + +Dynamic specialists are encouraged (e.g. `@React-Developer`, `@Kubernetes-Engineer`). + +## Example Usage ```bash @PM break down the story @@ -66,19 +72,21 @@ Claude Code model selection remains user‑controlled. Set it via: - project `.claude/settings.json` - CLI or `/model` -## Migration (v9 → v10.1) +## Contributing / Branches + +- Open PRs against `dev` (development branch). +- Release flow is `dev` -> `main` with a version bump, tag, and GitHub release. + +## Works With -- **Skills-first architecture** — 35 skills replace behavior-heavy approach. -- **Cross-platform** — Skills work with Claude Code, Codex CLI, Cursor, Gemini CLI, etc. -- **Work queue** — `.agent/queue/` replaces AgentTask XML templates. -- **Behaviors trimmed** — Only 4 foundational behaviors remain. -- **Minimal hooks** — 2 PreToolUse hooks (git-privacy via skill instead of hook). +Skills are plain `SKILL.md` folders, so they work across tools that support this format (Claude Code, Codex, Cursor, etc.). ## Docs - Start: `docs/index.md` - Installation: `docs/installation-guide.md` - Configuration: `docs/configuration-guide.md` +- Skills reference: `docs/skills-reference.md` - Hooks: `docs/hook-registration-reference.md` ## License diff --git a/VERSION b/VERSION index 4149c39e..26ee5b05 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -10.1.0 +10.2.1 diff --git a/src/VERSION b/src/VERSION index 4149c39e..26ee5b05 100644 --- a/src/VERSION +++ b/src/VERSION @@ -1 +1 @@ -10.1.0 +10.2.1