v6.2.0

Release 6.2.0 — 2026-11-04

Summary

ycc 6.2.0 adds the artifact store: planning, implementation, review and report skills can keep their artifacts as Linear documents and issues (with a local .ycc/artifacts/ cache) instead of docs/plans and docs/prps files, and ycc:init records the choice in a committed pointer. Linear is now the default store for repositories without a store configuration; existing local plans and reviews keep working. install.sh gains --dry-run on every target and step, and project scope for the settings step and Claude hooks.

Added

6adf61f feat(skills): route review and report artifacts through the artifact store (YAN-1156) (#512)
c4fe176 feat(skills): default the artifact store to linear (YAN-1618) (#505)
520c15e feat(install): project scope for the settings step (YAN-218) (#499)
b449460 feat(install): preview settings, rules, hooks and base removal under --dry-run (YAN-1568, YAN-219) (#495)
668a7f1 feat(skills): wire the artifact store into ycc:init with a committed pointer (YAN-1157) (#490)
1458d7a feat(skills): implement linear-mode plans and sync Linear status (YAN-1155) (#486)
8e43b80 feat(skills): route planning skills through the artifact store (YAN-1154) (#481)
a7c3814 feat(skills): artifact-store design reference and resolver helper (YAN-1152, YAN-1153) (#477)
6ed71c6 feat(install): project-scope claude hooks via the native ycc-hooks plugin (#466)
9bafd4d feat(install): add --dry-run to every target's sync and remove (YAN-215) (#463)

Changed

588141c ci(omp): bound apt in the Linux bubblewrap setup step (#461)
06be627 docs: weekly sync for week of 2026-10-26
8c88455 docs: weekly sync for week of 2026-10-19
6402acf docs(internal): add Pi runtime contract spike and ADR 0003 (YAN-1182) (#519)

Removed

None this release.

Fixed

189a230 fix(artifact-store): close .gitignore cache-rule gaps (YAN-1839, YAN-1840) (#518)
91131c1 fix(artifact-store): count gitignore coverage only when no repository negation can re-include the cache (YAN-1810) (#514)
4e1f68b fix(artifact-store): refuse .ycc/ gitignore negations and leave no cache on refusal (YAN-1790, YAN-1791) (#511)
54cee43 fix(scripts): stop plan-workflow fixtures from turning the repo bare (#507)
60bd1f5 fix(artifact-store): append repo .ycc/artifacts/ rule when only global or info excludes ignore it (#504)
106b520 fix(generators): expand quoted ~ in legacy codex render; gate ${HOME} rewrite to shell/Markdown (#498)
bbdcad8 fix(generators): drop dead _shared helper fallbacks and expand quoted ~ paths (#496)
e0ecdb1 fix(skills): read plan bodies in code-report and research-to-issues prereqs (YAN-1674) (#492)
7e409fa fix(skills): keep leading thematic breaks in artifact bodies (YAN-1631) (#489)
d14010c fix(skills): capture tea login list before matching under pipefail (#485)
61f60c4 fix(ci): declare scripted omp model context window so S5 never compacts (#482)
979455e fix(skills): match helper text without SIGPIPE races and keep analyze-changes alive (#476)
41eee56 fix(skills): count and match plan text without pipe races (#471)
33cce81 fix(agents): record fixer shell-scope enforcement per runtime (#468)
9c3150c fix(clean): count empty findings correctly and fail report generation loudly (#465)
d80e1aa fix(release): pin opencode npm install line and wait for npm latest after publish (#462)

Packages

Package	Runtime	Status	Mechanism	Listed	Version or target	Notes
@yandy-r/ycc-opencode	opencode	included	npm	no	6.2.0	experimental; opt-in; not yet published; Experimental and opt-in in v6; the @yandy-r npm scope is already owned. The V2 setup hook registers components and delivers instructions through the context hook; install.sh file copy stays the primary opencode path.
ycc	claude	included	native	yes	6.2.0	Shipping entry; stays visible in every catalog throughout the v6 flip. status-bar@ycc-mods is versioned independently and stays outside this manifest.
ycc	codex	included	native	yes	6.2.0	Listed in the ycc Codex catalog (.agents/plugins/marketplace.json) with a local source at ./.codex-plugin/ycc; installs together with ycc-mcp. Replaces the legacy local-ycc-plugins catalog.
ycc	cursor	included	native	yes	6.2.0	Ships through the GitHub marketplace; no cursor.com submission before post-6.0.
ycc	omp	included	native	yes	6.2.0	Generated OMP package under packages/omp/ycc (omp >=18.12.2) with .omp-plugin and .claude-plugin manifests and package.json, rewritten ${CLAUDE_PLUGIN_ROOT}, /ycc: and _shared references, agents translated to @ROLE models, and one commands/.md entrypoint per public skill (/ycc:). Listed in the root .omp-plugin/marketplace.json (YAN-1180). install.sh --target omp exports it to a local marketplace (--mode local) or registers the repository catalog (--mode repo) and installs it through omp plugin (user or project scope).
ycc-agents	claude	deferred	native	no	target v7.0.0	Deferred to v7.0.0 as a breaking change with qualified ycc-agents: references; the v6 namespace spike rejects a shared manifest name. Hidden prep: claude_agents_split.py builds and validates the split on demand (claude-native check); test-claude-agents-split.sh is the opt-in live dispatch proof.
ycc-all	claude	included	native	yes	6.2.0	Meta plugin that installs ycc, ycc-mcp, and ycc-hooks through Claude plugin dependencies.
ycc-all	omp	excluded	native	no	target v6.1.0	Excluded: the OMP marketplace does not read plugin dependencies, so ycc-all (on Claude the union of ycc, ycc-mcp, and ycc-hooks) is omitted from the OMP catalog; install ycc and ycc-mcp separately; herdr reporting comes from herdr integration install omp.
ycc-hooks	claude	included	native	yes	6.2.0	Native plugin hooks/hooks.json needs Claude Code 2.1.300 or later; older clients keep installer-managed hooks. After enabling ycc-hooks@ycc, install.sh migrate --target claude --apply prunes the installer hooks.
ycc-hooks	codex	excluded	native	no	target v6.0.0	Excluded: NO-GO until verified under YAN-1149 (YAN-1149 gate). Hooks stay out of the Codex bundle.
ycc-hooks	cursor	included	native	yes	6.2.0	sessionStart only; WorktreeCreate stays on install.sh.
ycc-hooks	omp	excluded	native	no	target v6.1.0	Excluded: herdr ships its own OMP integration (herdr integration install omp), which reports the session and agent state; a ycc reporter is ignored by herdr (non-herdr source) or corrupts herdr's ordering (herdr:omp). WorktreeCreate has no OMP event. ycc ships no OMP hooks (YAN-1174); its only OMP extension is the agent scope guard inside the ycc package (YAN-1250).
ycc-mcp	claude	included	native	yes	6.2.0	Native MCP-only plugin.
ycc-mcp	codex	included	native	yes	6.2.0	Native MCP-only plugin; carries the MCP servers the Codex ycc plugin used to ship. Listed together with ycc.
ycc-mcp	cursor	included	native	yes	6.2.0	Native MCP-only plugin.
ycc-mcp	omp	included	native	yes	6.2.0	Generated OMP package under packages/omp/ycc-mcp (omp >=18.12.2) with .omp-plugin and .claude-plugin manifests, package.json, and a root .mcp.json byte-identical to mcp-configs/mcp.json (secret-literal audited; ${VAR} env placeholders stay unexpanded until omp starts a server). Servers load as ycc-mcp:. Listed in the root .omp-plugin/marketplace.json (YAN-1180). install.sh --target omp installs it next to ycc through omp plugin (user or project scope); a running session picks it up after /reload-plugins or a restart.
ycc-rules	cursor	included	native	yes	6.2.0	Cursor-only rules package. No Claude ycc-rules: Claude rules stay on install.sh (see installer-fallback claude).
ycc-rules	omp	included	native	yes	6.2.0	Generated package under packages/omp/ycc-rules (omp >=18.12.2): 31 flat rules named ycc--, paths→globs, description kept, alwaysApply only when true. Language rules are rulebook entries read via rule://; 5 description-less ycc--trigger TTSR rules (glob-gated edit/write, interruptMode never) attach them once per session and once per subagent that edits a matching file. Listed in the root .omp-plugin/marketplace.json (YAN-1180).

File-copy packages (the installer fallback) have no native manifest and are not versioned here.

Validation

• ./scripts/sync.sh — OK
• ./scripts/validate.sh — OK
• python3 -m json.tool .claude-plugin/marketplace.json — OK
• python3 -m json.tool ycc/.claude-plugin/plugin.json — OK

Upgrade Notes

No breaking changes for installs. Existing local plans and reviews keep working without configuration. New artifacts in a repository with no store configuration go to Linear, which needs a reachable Linear MCP server; add store: local to keep the previous behavior.

• Artifact store default: in a repository with no store configuration, planning and review skills now write to Linear (default store: linear). Existing local plans and reviews under docs/plans/ and docs/prps/reviews/ are still found and used in local mode, with a one-line pin hint. To keep everything local, add store: local to .plans-config, or pass --store=local to a single run. Linear mode needs a reachable Linear MCP server.
• install.sh --dry-run now works for every target's sync and remove; --target all --only <step> skips targets without that step instead of failing.
• Project-scope installs (--project) now cover the settings step and Claude hooks through the native ycc-hooks plugin.

Commit Log

6402acf docs(internal): add Pi runtime contract spike and ADR 0003 (YAN-1182) (#519)
189a230 fix(artifact-store): close .gitignore cache-rule gaps (YAN-1839, YAN-1840) (#518)
91131c1 fix(artifact-store): count gitignore coverage only when no repository negation can re-include the cache (YAN-1810) (#514)
6adf61f feat(skills): route review and report artifacts through the artifact store (YAN-1156) (#512)
4e1f68b fix(artifact-store): refuse .ycc/ gitignore negations and leave no cache on refusal (YAN-1790, YAN-1791) (#511)
54cee43 fix(scripts): stop plan-workflow fixtures from turning the repo bare (#507)
c4fe176 feat(skills): default the artifact store to linear (YAN-1618) (#505)
60bd1f5 fix(artifact-store): append repo .ycc/artifacts/ rule when only global or info excludes ignore it (#504)
06be627 docs: weekly sync for week of 2026-10-26
520c15e feat(install): project scope for the settings step (YAN-218) (#499)
106b520 fix(generators): expand quoted ~ in legacy codex render; gate ${HOME} rewrite to shell/Markdown (#498)
b449460 feat(install): preview settings, rules, hooks and base removal under --dry-run (YAN-1568, YAN-219) (#495)
bbdcad8 fix(generators): drop dead _shared helper fallbacks and expand quoted ~ paths (#496)
e0ecdb1 fix(skills): read plan bodies in code-report and research-to-issues prereqs (YAN-1674) (#492)
668a7f1 feat(skills): wire the artifact store into ycc:init with a committed pointer (YAN-1157) (#490)
7e409fa fix(skills): keep leading thematic breaks in artifact bodies (YAN-1631) (#489)
1458d7a feat(skills): implement linear-mode plans and sync Linear status (YAN-1155) (#486)
d14010c fix(skills): capture tea login list before matching under pipefail (#485)
61f60c4 fix(ci): declare scripted omp model context window so S5 never compacts (#482)
8e43b80 feat(skills): route planning skills through the artifact store (YAN-1154) (#481)
8c88455 docs: weekly sync for week of 2026-10-19
a7c3814 feat(skills): artifact-store design reference and resolver helper (YAN-1152, YAN-1153) (#477)
979455e fix(skills): match helper text without SIGPIPE races and keep analyze-changes alive (#476)
6ed71c6 feat(install): project-scope claude hooks via the native ycc-hooks plugin (#466)
41eee56 fix(skills): count and match plan text without pipe races (#471)
33cce81 fix(agents): record fixer shell-scope enforcement per runtime (#468)
9c3150c fix(clean): count empty findings correctly and fail report generation loudly (#465)
588141c ci(omp): bound apt in the Linux bubblewrap setup step (#461)
9bafd4d feat(install): add --dry-run to every target's sync and remove (YAN-215) (#463)
d80e1aa fix(release): pin opencode npm install line and wait for npm latest after publish (#462)

---

Previous release: v6.1.1