refactor: move CCG guidance into agent skills

Author: tae2089

AGENTS.md

@@ -44,7 +44,6 @@ Main commands:
 - `ccg search <query>` - full-text search (includes annotations)
 - `ccg lint [--strict]` - check documentation quality
 - `/ccg-annotate annotate [file|dir]` - AI annotation generation workflow
-- `ccg example [language]`, `ccg tags` - annotation examples and tag reference
 
 Use `.ccg.yaml` to manage project defaults such as exclude patterns and DB settings.
 

guide/annotations.md

@@ -108,21 +108,13 @@ Agent: reads code → generates @intent, @domainRule, @sideEffect, @mutates
        → now searchable by business context
 ```
 
-### CLI
-
-```bash
-# Show annotation examples
-ccg example go
-ccg example python
-
-# Full tag reference
-ccg tags
-```
-
 ### Skill
 
 Use directly in a skill-capable coding agent with the `/ccg-annotate` skill:
 
 ```
 /ccg-annotate annotate internal/   — AI-generate annotations
 ```
+
+The project-local skill keeps its complete tag contract and comment-syntax
+examples in [`skills/ccg-annotate/references/annotation-reference.md`](../skills/ccg-annotate/references/annotation-reference.md).

guide/cli-reference.md

@@ -48,9 +48,6 @@ ccg update ./backend --namespace backend
 | `ccg docs --rag-index-dir <dir>` | Override the legacy-named Wiki index output directory (default `.ccg` or `rag.index_dir`) |
 | `ccg docs --prune=false` | Regenerate docs without deleting older generator-managed files |
 | `ccg docs --exclude <pat>` | Exclude files/paths from generated docs (repeatable) |
-| `ccg languages` | List supported languages and extensions |
-| `ccg example [language]` | Show annotation writing example |
-| `ccg tags` | Show all annotation tag reference |
 | `ccg hooks install` | Install pre-commit git hook |
 | `ccg hooks install --lint-strict` | Install hook that blocks commit on issues |
 | `ccg lint [--out dir]` | 8-category docs lint |

guide/development.md

@@ -126,6 +126,24 @@ The dist directory is ignored by git and packaged separately for releases:
 make wiki-build
 ```
 
+## Skill Contract
+
+Each project-local skill under `skills/` declares:
+
+- trigger-rich `name` and `description` frontmatter
+- semantic `metadata.version`
+- `metadata.openclaw.category` and `domain`
+- required binaries and prerequisite skills under `metadata.requires`
+- `metadata.cliHelp` only when the skill has a direct CLI help surface
+
+Keep detailed variants in directly linked `references/` files and keep core
+`SKILL.md` instructions host-neutral. Validate metadata, dependencies, direct
+reference links, and removed-command drift with:
+
+```bash
+go test ./internal/cli -run TestProjectSkills -count=1
+```
+
 ## Conventions
 
 - TDD: Red → Green → Refactor

guide/ko/annotations.md

@@ -104,21 +104,13 @@ Agent: 코드 분석 → @intent, @domainRule, @sideEffect, @mutates 생성
        → 이제 비즈니스 컨텍스트로 검색 가능
 ```
 
-### CLI
-
-```bash
-# 어노테이션 예시 보기
-ccg example go
-ccg example python
-
-# 전체 태그 레퍼런스
-ccg tags
-```
-
 ### 스킬 (Skill)
 
 스킬을 지원하는 코딩 에이전트에서 `/ccg-annotate` 스킬을 직접 사용하십시오:
 
 ```
 /ccg-annotate annotate internal/   — AI를 사용하여 어노테이션 자동 생성
 ```
+
+전체 태그 계약과 언어별 주석 문법 예시는 프로젝트 로컬 skill의
+[`skills/ccg-annotate/references/annotation-reference.md`](../../skills/ccg-annotate/references/annotation-reference.md)에 있습니다.

guide/ko/cli-reference.md

@@ -50,9 +50,6 @@ ccg update ./backend --namespace backend
 | `ccg docs --rag-index-dir <dir>` | legacy 이름을 유지한 Wiki index 출력 디렉터리 지정 (기본 `.ccg` 또는 `rag.index_dir`) |
 | `ccg docs --prune=false` | 기존 generator-managed 문서를 삭제하지 않고 문서만 다시 생성 |
 | `ccg docs --exclude <pat>` | 문서 생성 대상에서 파일/경로 제외 (반복 가능) |
-| `ccg languages` | 지원되는 언어 및 확장자 목록 출력 |
-| `ccg example [language]` | 어노테이션 작성 예시 출력 |
-| `ccg tags` | 모든 어노테이션 태그 레퍼런스 출력 |
 | `ccg hooks install` | pre-commit git 훅 설치 |
 | `ccg hooks install --lint-strict` | 문제가 있을 경우 커밋을 차단하는 훅 설치 |
 | `ccg lint [--out dir]` | 8가지 카테고리의 문서 린트(lint) 실행 |

guide/ko/development.md

@@ -128,6 +128,24 @@ dist 디렉터리는 git에서 제외하고 release에서 별도 asset으로 패
 make wiki-build
 ```
 
+## Skill 계약 (Skill Contract)
+
+`skills/` 아래의 모든 프로젝트 로컬 skill은 다음을 frontmatter에 선언합니다:
+
+- 실제 trigger가 포함된 `name`과 `description`
+- semantic `metadata.version`
+- `metadata.openclaw.category`와 `domain`
+- `metadata.requires` 아래의 필수 binary와 선행 skill
+- 직접 대응하는 CLI help가 있을 때만 `metadata.cliHelp`
+
+세부 variant는 `SKILL.md`에서 직접 연결한 `references/` 파일에 두고, 핵심
+`SKILL.md` 지침은 특정 host에 종속되지 않게 유지합니다. metadata, dependency,
+직접 reference link, 제거된 command drift는 다음 명령으로 검증합니다:
+
+```bash
+go test ./internal/cli -run TestProjectSkills -count=1
+```
+
 ## 컨벤션 (Conventions)
 
 - TDD: Red → Green → Refactor

internal/cli/config_test.go

@@ -220,12 +220,12 @@ func TestConfigFlag_LoadsYAML(t *testing.T) {
 	}
 
 	deps, stdout, stderr := newTestDeps()
-	// tags command doesn't need DB, so it works without InitFunc
-	if err := executeCmd(deps, stdout, stderr, "--config", cfgFile, "tags"); err != nil {
+	// version does not need DB, so config loading can be tested without InitFunc.
+	if err := executeCmd(deps, stdout, stderr, "--config", cfgFile, "version"); err != nil {
 		t.Fatalf("unexpected error: %v", err)
 	}
 
-	if !strings.Contains(stdout.String(), "@index") {
-		t.Errorf("expected tags output, got: %s", stdout.String())
+	if !strings.Contains(stdout.String(), "ccg dev") {
+		t.Errorf("expected version output, got: %s", stdout.String())
 	}
 }