本文へ移動
cccskills
無料GitHub で公開

codev

Codev project management CLI — init, adopt, bootstrap-docs, update, and doctor commands. Check this skill before running any `codev` command (except `consult`, `porch`, or `afx` which have their own skills). Use when setting up new projects, adding codev to existing repos, updating framework files, or diagnosing missing dependencies.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codevスター 290(GitHub 290 + cccskills 0)

実行スコア 未検証

インストール方法を見る

含まれるファイル（1）

  • SKILL.md4.8 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

codev - Project Management CLI

Commands

codev init [project-name]      Create a new codev project directory
codev adopt                    Add codev to the current directory
codev bootstrap-docs           Draft the governance docs from this codebase
codev update                   Update protocols, roles, skills from package
codev doctor                   Check system dependencies

codev init

Creates a new directory with the full codev structure: specs/, plans/, reviews/, protocols, CLAUDE.md, AGENTS.md, .claude/skills/, .codex/skills/, .codev/config.json, and .gitignore.

codev init my-app              # Interactive setup
codev init my-app -y           # Non-interactive with defaults

codev adopt

Adds codev to the current directory (existing project). Run from the project root. If CLAUDE.md or AGENTS.md already exists, creates .codev-new versions and spawns Claude to merge.

codev adopt                    # Interactive
codev adopt -y                 # Skip conflict prompts

On a project with code, adopt then offers to draft the governance docs (default No); with -y it only prints the command.

codev bootstrap-docs

Drafts codev/resources/{arch,lessons-learned,arch-critical,lessons-critical}.md from the codebase and git history. Rewrites only files that are still untouched starters; curated files are never edited. Always confirms before launching the agent, then reports what changed and runs a three-way review of the drafts. Nothing is committed.

codev bootstrap-docs --dry-run # Eligible files and the launch, nothing run
codev bootstrap-docs           # Draft, report, review

codev update

Updates framework files (protocols, roles, skills) from the installed @cluesmith/codev package. Never touches user data (specs, plans, reviews). Creates .codev-new versions for customized files. Missing Claude and Codex skills are added. A skill you never edited is replaced with the package's version; an edited one is kept and gets <file>.codev-new copies to merge.

codev update                   # Interactive update
codev update --dry-run         # Preview changes
codev update --force           # Overwrite all framework files
codev update --agent           # Agent mode: JSON stdout, no interactive merge

codev doctor

Checks all required dependencies: Node.js (>=18), git (>=2.5), gh (authenticated), and at least one AI CLI (Claude, Gemini, or Codex).

codev doctor

Common mistakes

  • There is NO codev tower command — use afx tower start/stop
  • codev init creates a new directory — use codev adopt for existing projects
  • Always run codev adopt and codev update from the project root
  • codev update only updates framework files — it never touches specs/plans/reviews

Local build and install (this repository)

Test changes locally before publishing. Run from the repository root:

pnpm build                  # builds core first, then codev (including dashboard)
pnpm -w run local-install   # packs both packages, installs globally, restarts Tower

local-install (scripts/local-install.sh) packs @cluesmith/codev-core and @cluesmith/codev, installs both in a single npm install -g (separate installs fail — codev-core is not on the public registry), restores the executable bit on scripts/forge/**/*.sh that pnpm pack strips, and restarts Tower last. Install runs while Tower is up; only the final restart causes downtime. Do not stop Tower first, and do not use npm link / pnpm link — it breaks global installs.

pnpm build also runs copy-skeleton, which copies codev-skeleton/ into packages/codev/skeleton. Tests read that copy, so after editing anything under codev-skeleton/ you must rebuild before the suite reflects your change.

Run codev update in this repository only with a package built from it. An older installed package treats unpublished skill edits as local edits: it writes .codev-new copies holding the older text (a merge can fold that back in), and --force overwrites the edits outright.

Where to run things

  • pnpm install — repository root (installs all workspace packages)
  • pnpm build / pnpm test — packages/codev/, or pnpm --filter @cluesmith/codev build
  • Unit tests packages/codev/tests/unit/ · E2E packages/codev/tests/e2e/
  • Never run npm commands from the repository root unless told to

Measuring code size

tokei -e "tests/lib" -e "node_modules" -e ".git" -e ".builders" -e "dist" .

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

afx

無料

Agent Farm CLI — the tool for spawning builders, managing Tower, workspaces, and cron tasks. ALWAYS consult this skill BEFORE running any `afx` command to get the exact syntax. This prevents wasting time guessing flags that don't exist. Use this whenever you need to spawn a builder, check status, send messages, clean up worktrees, manage Tower, or run cron tasks. If you're about to type `afx` followed by anything, check here first.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

arch-init

無料

Adopt an architect identity and recover its state from codev/state/<name>.md. Use when an architect terminal needs to (re)establish which architect it is — after a restart, context loss, or session handoff — or when the user says "/arch-init", "you are the X architect", or "recover your architect state". Identity resolves via `afx whoami` (an explicit name argument overrides); if neither resolves, ask the human — never guess.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

arch-save

無料

Save an architect's state, clear its context, and re-init automatically — the packaged save→clear→re-init refresh cycle. Use when the owner directs a context refresh, or says "/arch-save", "save and clear", "refresh your context". Runs on the owner's direction; an architect does not invoke it autonomously mid-task. Counterpart to /arch-init, which recovers the state this writes.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

builder-refresh

無料

Refresh a builder's own context at a protocol boundary — save working state, verify it, clear, and re-orient. Use when porch emits a context-refresh task, or the builder is told to "refresh your context" / "run a self-refresh". A builder does not invoke this autonomously mid-task; porch chooses the moment. Counterpart to the architect's /arch-save.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

consult

無料

AI consultation CLI — query Gemini, Codex, or Claude for reviews and analysis. ALWAYS check this skill before running any `consult` command. Use when reviewing specs, plans, implementations, or PRs with external models, running parallel 3-way reviews (cmap), or checking consultation stats. The `-m` model flag is always required except for `consult stats`.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

generate-image

無料

AI image generation via Gemini with optional async providers. Use when the user wants to generate, create, or make an image, or when you need to create visual assets like logos, diagrams, or illustrations. Requires the API key for the selected provider.

日本語の概要は準備中です。原文の説明を表示しています。

cluesmith/codev2902026年10月24日 更新

cluesmith のスキルをすべて見る

このスキルの問題を報告する