Add companion doc support and orbit layers #1

Merged

arne merged 5 commits from adopt-conventions into main 2026-04-06 15:01:30 +02:00

Conversation 0 Commits 5 Files changed 7 +793 -3

arne commented 2026-04-06 11:18:41 +02:00

Owner

Copy link

apply.sh only manages CLAUDE.md content today. Some conventions are better
expressed as standalone reference documents — detailed PR/issue guidelines,
protection rules for styleguide directories — rather than inlined in CLAUDE.md.

This adds companion doc directories to the layer system. If a layer has a
companion directory (layers/{name}/), apply.sh copies its files into
docs/conventions/ in the target repo. The layer's CLAUDE.md content contains
directives pointing to those docs.

Also restructures the orbit layer (slimmer directives, PR/issue guidelines
moved to a reference doc) and adds an orbit-design layer for projects with
a styleguide directory.

apply.sh only manages CLAUDE.md content today. Some conventions are better expressed as standalone reference documents — detailed PR/issue guidelines, protection rules for styleguide directories — rather than inlined in CLAUDE.md. This adds companion doc directories to the layer system. If a layer has a companion directory (layers/{name}/), apply.sh copies its files into docs/conventions/ in the target repo. The layer's CLAUDE.md content contains directives pointing to those docs. Also restructures the orbit layer (slimmer directives, PR/issue guidelines moved to a reference doc) and adds an orbit-design layer for projects with a styleguide directory.

arne added 5 commits 2026-04-06 11:18:41 +02:00

Add conventions adoption design spec and plan 1cdc19d8fd

Restructure orbit layer with companion docs 828e188605

Add orbit-design layer with design protection docs 65a5f43e09

Copy companion docs from layer directories ... 0e1bb39dd2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Harden companion doc copy: glob safety and recursive support fa3f9c1f8e

arne merged commit 95f3d48f55 into main 2026-04-06 15:01:30 +02:00

arne referenced this pull request from a commit 2026-04-06 15:01:31 +02:00

Add companion doc support and orbit layers (#1)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

arne/conventions!1

No description provided.