/cco-patterns

name: cco-patterns
description: Share learned file patterns across a team — export an anonymized digest of what's usually waste/useful/co-edited, and import a teammate's so a fresh clone benefits day one
license: MIT
argument-hint: "[export [--out <file>] | import <file> | show]"
allowed-tools: [Bash, Read]

CCO Patterns — share what the project has learned

Patterns are learned per-machine, per-project: which files are usually waste, which are usually useful, which get edited together. A teammate's fresh clone starts blind and re-learns the same lessons by wasting the same tokens.

This makes them portable. Run from the plugin root (the directory containing `src/patterns-share.js`).

Parse $ARGUMENTS:

`export`

node src/patterns-share.js export

Writes `.cco/patterns.digest.json` in the project (override with `--out`).

The digest contains **relative paths and counts only** — no file contents, no absolute paths, no home directory. Entries that can't be expressed relative to the project root are dropped, and the command reports how many. The file is audited before writing; if anything identifying slipped in, it refuses to write rather than produce a file someone might commit.

Tell the user the digest is safe to commit, and that committing it is the point: teammates get it on clone.

`import <file>`

node src/patterns-share.js import .cco/patterns.digest.json

Merges into the current project's patterns. **Imported data is stored as a separate prior — it never touches the user's own counts.**

This matters and is worth saying out loud: `confidence` is computed from how many sessions *this machine* observed a file in. Folding someone else's sessions into that number would make the user's own confidence a lie. So the import fills in only where the user has no observations of their own — the fresh-clone case — and local evidence always wins.

The digest is audited on the way in too, since it came from elsewhere. A file with absolute paths or traversal segments is rejected, not sanitized.

`show`

node src/patterns-share.js show

Lists what was imported for this project and how each file is labelled.

Suggesting this

Worth offering when:

• The user is setting up a repo for a team and asks about onboarding cost.
• A project has meaningful waste history (`/cco-shield` shows repeat offenders)

that every teammate will otherwise rediscover.

• Someone just cloned a repo that already has `.cco/patterns.digest.json` —

offer to import it.