Project Folder Convention v2

Changelog

A running record of changes to this guide.

A running record of changes to this guide. Spec updates land in periphery-os/conventions/project-folder-convention.md (git canonical; Drive mirror is read-only); this guide lags a release behind.

v1.32026-05-24Current

Added Intake Model (Inbox-first routing) + new Reference/ and Deliverables/ folder chapters. Pier West established as canonical reference implementation for both bins.

Added

  • New "Intake Model" section in canonical convention .md — default path (drop in Inbox/), fast path (direct drop), forbidden (project root), exempt cases
  • New Reference/ chapter (07) — 6 subfolders documented (brand/, creative-specs/, creative-sources/, ooh-proposals/, leads/, History/) plus root singletons
  • New Deliverables/ chapter (08) — 4 zones documented (current cycle bundles, Reports/, _archive/, root singletons) with skill-write exemption and the _archive/ vs _junk/ distinction
  • 3-item rule for singleton-to-subfolder promotion at both Reference/ and Deliverables/ root
  • Pier West live trees as canonical worked examples — including BOSA developer cross-folder pattern (Reference/) and 5-media-plan archive (Deliverables/)
  • Intake Model hero callout on the index page (default / fast / forbidden tiers)

Changed

  • Reference/ subfolder spec in convention .md rewritten to match Pier West v7 reality (was: brand-voice.md/brand-guidelines//creatives//builds/ at root; now: brand/, creative-specs/, creative-sources/, ooh-proposals/, leads/, History/, root singletons)
  • Deliverables/ subfolder spec in convention .md rewritten to match Pier West v7 reality (added Reports/, _archive/ with sub-bundles, clarified _archive/ vs _junk/ distinction, skill-write exemption)
  • Asset routing quick-reference tables updated for new subfolder paths in both bins
v1.22026-05-21

Documented /update-context per chapter — what routes where, what the rubric does, Change Log format.

Added

  • New "How this file gets updated" section in every chapter: invocation, content-routing rules for that specific file, role-based rubric (silent / confirm / clarify), and Change Log entry format
  • For health.md and performance.md: documented the agent-only reject pattern + redirect examples (where each kind of write actually belongs)
v1.12026-05-21

Embedded the full real Marcon — Elmwood files at the bottom of each chapter as a collapsible reference.

Added

  • Collapsible "View the full real {file}" block at the bottom of CLAUDE.md, campaign.md, production.md, and digital.md chapters — the full live Elmwood source, snapshotted 2026-05-13
  • Placeholder note on health.md and performance.md chapters explaining Elmwood doesn't have one yet (agent-generated; runs after first campaign-director / media-agent cycle)
  • New .file-embed details/summary styling in guide.css + .callout-note aside style
v1.02026-05-13

Initial release of the v2 file set explainer.

Added

  • Overview index with file-set-at-a-glance and five-bin layout
  • Chapter for each of the 6 v2 root files (CLAUDE.md, campaign.md, production.md, digital.md, health.md, performance.md)
  • Real Marcon Elmwood examples in every chapter
  • How-the-files-work-together walkthrough using a Misael ad-set build scenario
  • What-this-replaces section explaining v1 to v2 deltas