vibe-coding-master 0.3.27 → 0.3.29

package/docs/vcm-cc-best-practices.md

@@ -1,13 +1,14 @@
 # VCM Claude Code Best Practices
 
-Last updated: 2026-06-08
+Last updated: 2026-06-21
 
 This is the current VCM-specific Claude Code / AI coding best-practices guide.
 It is based on the latest `example/rust-layered` harness baseline.
 
 Do not install this document into target repositories. Target repositories should
-receive a concise root `CLAUDE.md` VCM block, four role agents, repo-local VCM
-skills, harness tools, and project-owned durable docs.
+receive a concise root `CLAUDE.md` VCM block, role agents, repo-local VCM
+skills, harness tools, Codex Translator harness files, and project-owned
+durable docs.
 
 `docs/cc-best-practices.md` is archived as the old generic baseline. Current VCM
 implementation should use this document and `docs/full-harness-baseline.md`.
@@ -17,7 +18,7 @@ implementation should use this document and `docs/full-harness-baseline.md`.
 VCM separates three concerns:
 
 - Harness-managed files: VCM owns, upgrades, repairs, audits, and can uninstall
-  these through `.ai/vcm-harness-manifest.json`.
+  these through deterministic installer definitions and managed markers.
 - Project-owned durable docs: VCM bootstrap may create or initialize these, but
   they become project truth and are not VCM-owned harness.
 - Runtime state: VCM writes these during task execution and cleans them up after
@@ -41,13 +42,19 @@ CLAUDE.md
 .claude/agents/architect.md
 .claude/agents/coder.md
 .claude/agents/reviewer.md
+.claude/agents/gate-reviewer.md
 .claude/skills/vcm-route-message/SKILL.md
 .claude/skills/vcm-final-acceptance/SKILL.md
 .claude/skills/vcm-long-running-validation/SKILL.md
 .claude/skills/vcm-harness-bootstrap/SKILL.md
-.ai/vcm-harness-manifest.json
+.claude/skills/vcm-gate-review/SKILL.md
+.ai/codex-translator/AGENTS.md
+.ai/codex-translator/config.toml
+.ai/codex-translator/.codex/config.toml
+.ai/codex-translator/.codex/hooks.json
 .ai/tools/generate-module-index
 .ai/tools/generate-public-surface
+.ai/tools/request-gate-review
 .ai/tools/run-long-check
 .ai/tools/watch-job
 .ai/tools/vcm-bash-guard
@@ -61,9 +68,8 @@ Derived bootstrap artifacts:
 .ai/generated/public-surface.json
 ```
 
-The generated artifacts are tracked in the manifest as derived artifacts so VCM
-can clean or refresh them, but they are produced by generator tools during
-bootstrap or later maintenance work. They are not hand-authored fixed templates.
+The generated artifacts are produced by generator tools during bootstrap or
+later maintenance work. They are not hand-authored fixed templates.
 
 Runtime roots:
 
@@ -80,6 +86,7 @@ Not part of the current baseline:
 .ai/task-specs/
 .ai/vcm/tasks/
 .ai/vcm/handoffs/role-commands/
+.ai/vcm-harness-manifest.json
 docs/plans/active/
 docs/plans/completed/
 docs/MODULE_MAP.md
@@ -100,35 +107,31 @@ docs/AI_WORKFLOW.md
 
 Do not reintroduce these unless there is a current VCM requirement.
 
-## 3. Harness Manifest
+## 3. Harness Ownership
 
-`.ai/vcm-harness-manifest.json` is a VCM harness ownership and lifecycle record.
-It is not a project-document index.
+VCM harness ownership is defined by the installer code and by managed markers.
+The current implementation does not use `.ai/vcm-harness-manifest.json`.
 
-It should record:
+VCM-owned managed blocks use markers such as:
 
-- VCM-managed files and directories
-- managed-block marker type and boundaries
-- JSON merge ownership, especially `.claude/settings.json` hooks
-- VCM agent and skill files
-- harness tools under `.ai/tools/`
-- generated context artifacts under `.ai/generated/`
-- PR template managed blocks
-- lifecycle labels
-- runtime roots
-- uninstall actions
+```md
+<!-- VCM:BEGIN version=1 -->
+...
+<!-- VCM:END -->
+```
 
-It should not record:
+For `.gitignore`, VCM uses:
 
-- project-owned durable docs such as `docs/ARCHITECTURE.md`,
-  `docs/TESTING.md`, `docs/known-issues.md`, `docs/plans/`, or module-level
-  `ARCHITECTURE.md`
-- `.ai/vcm/**` runtime files
-- `.claude/worktrees/**` task worktrees
-- placeholder `.gitkeep` files
+```gitignore
+# VCM:BEGIN version=1
+...
+# VCM:END
+```
 
-VCM uninstall should remove only VCM-owned managed blocks or unchanged VCM-owned
-whole files. User-authored project docs must not be deleted by harness uninstall.
+Whole-file and raw-file harness files are owned by VCM only when their paths are
+listed by the fixed installer. VCM uninstall should remove only VCM-owned
+managed blocks or unchanged VCM-owned whole files. User-authored project docs
+must not be deleted by harness uninstall.
 
 ## 4. Project-Owned Durable Docs
 
@@ -169,6 +172,7 @@ Current runtime files and directories:
 .ai/vcm/handoffs/docs-sync-report.md
 .ai/vcm/handoffs/final-acceptance.md
 .ai/vcm/handoffs/known-issues.md
+.ai/vcm/gate-reviews/
 .ai/vcm/jobs/<job-id>/
 .ai/vcm/bootstrap/session.json
 .ai/vcm/bootstrap/bootstrap.log
@@ -417,7 +421,7 @@ an invisible background task:
 
 The UI should expose both stages: fixed install status and bootstrap completion
 status. A failed or disconnected bootstrap terminal should be restartable
-without treating project-owned durable docs as VCM-owned manifest entries.
+without treating project-owned durable docs as VCM-owned harness files.
 
 ## 12. Final Acceptance
 
@@ -444,7 +448,6 @@ Temporary files should be deleted after the task:
 - route messages
 - handoff artifacts
 - job logs and status files
-- raw terminal logs
 - app-local task records
 - routine completed plans
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-coding-master",
-  "version": "0.3.27",
+  "version": "0.3.29",
   "description": "Local GUI session cockpit for Claude Code role sessions.",
   "type": "module",
   "files": [