ginee v0.22.0

Highlights

• Per-role context: −19 to −28% (#171). ai-engineer cross-iteration dedup pass — hundreds of feature iterations had introduced cross-file overlap without dedup checks. Every cardinal's per-dispatch load is now substantially smaller; ai-engineer 25k → 18k bytes (−28%) · team-lead 73k → 57k (−22%). Headroom against per-role ceilings goes from 19–37% up to 36–55% in the same release.
• Ceilings tightened to lock in the gains. scripts/templates/role-context-ceilings.json adjusted to ~30% headroom on the new (post-dedup) baseline. Future ordinary edits can grow context by ~30% before tripping the ai-engineer dispatch gate; loosening any ceiling continues to require ai-engineer review per docs/RELEASE.md step 3.
• Two new shared files cut role-kernel + adapter-install boilerplate — core/protocols/role-kernel-shared.md (7 cited sections absorbed from each role kernel) + adapters/_shared/install-common.md (4 cited sections absorbed from each adapter install.md).
• Template ↔ schema pairs merged. sub-issue-dispatch.md ↔ sub-issue-dispatch-schema.md and pr-comment-cadence.md ↔ review-cycle-schema.md consolidated. Schema sidecars retained as thin pointers — existing cross-references resolve unchanged.
• YAML frontmatter parse failure fixed for 4 pre-existing files. description: values containing : (which strict YAML parsers read as nested mappings) converted to folded-block scalar (>-). Surfaced when picked up by a stricter adopter parser; fixed forward.

Adopter migration

Nothing to do. Purely additive on the adopter side; local/* untouched; all @<role> + skill phrasings unchanged; old schema-sidecar paths still resolve via thin-pointer redirects. Re-run /ginee-update (or the bootstrap one-liner) to pick up the new shared files.

Per-change action

Change	Action
Shared role-kernel / install boilerplate (role-kernel-shared.md + install-common.md)	None — kernels + install.md cite the new files automatically.
Template+schema pair merges (sub-issue · review-cycle)	None — schema sidecars now thin pointers; existing cites resolve.
Tightened per-role ceilings	None for adopters — gate fires against framework-self-dev PRs only.
YAML frontmatter fixes	None — /ginee-update picks the corrected files up.

Notes

• Per-role context table. New baselines + headroom (post-tightening):

  Role	Bytes	Ceiling	Headroom
  ai-engineer	18,231	26,000	~30%
  qa-engineer	26,374	38,000	~31%
  backend-engineer	28,079	40,000	~30%
  frontend-engineer	28,148	40,000	~30%
  devops-engineer	32,059	46,000	~30%
  solution-architect	37,255	53,000	~30%
  team-lead	57,305	82,000	~30%

• Audit methodology. Five parallel Explore agents audited disjoint file clusters (schemas+templates · skills · phase+protocols · doc-family · extras+adapters); each returned a structured dedup report; the 11-cluster merge plan synthesised from their findings.

• Skill files preserved. ginee-file-{bug,feature} / ginee-file-framework-{bug,feature} left as 4 separate files per the merge-plan review — cheat-sheet phrasings stay stable for adopters.