Skip to content

Name Coded Apps <slug>-workshop-<target> - #6

Merged
ThisIsTJ merged 2 commits into
mainfrom
feat/coded-app-name-convention
Aug 28, 2026
Merged

ThisIsTJ merged 2 commits into
mainfrom
feat/coded-app-name-convention

Conversation

@ThisIsTJ

Copy link
Copy Markdown
Collaborator

The shape was never written down as a rule, only implied by the slug-budget
arithmetic — and the two places that did spell a pattern out both spelled a
different one. agents/base.md and init.mjs documented workshop-<slug>-local;
all five repos actually use <slug>-workshop-local, so the documented form had
zero users. The template scaffolded the documented form, which is how it would
have reached the next five-to-seven workshops.

The rule is now explicit: product slug, the literal workshop, then the target.
The variable part goes last so every app for one product sorts together. The
environment-first shape (growth-ixp-workshop) is retired, and no new staging
targets — the single existing one predates the rule.

The slug budget survives unchanged at 15 characters, with cleaner arithmetic:
-workshop- spends 10 of 32, leaving 22 to share, and reserving 7 for the target
name caps the slug at 15. init no longer prints a staging row.

Not changed: deriveCodedAppName still produces <productSlug>-<tenant>, which
does not match this convention. It is inert — no content repo sets productSlug
— and reshaping derivation changes live URLs, so it belongs in the deliberate
derived-names pass. base.md now says so rather than leaving the two shapes to be
discovered as a contradiction.

Includes the Release v1.7.0 version bump so the five content repos can repin.

🤖 Generated with Claude Code

ThisIsTJ and others added 2 commits August 27, 2026 12:55
The shape was never written down as a rule, only implied by the slug-budget
arithmetic, and the two places that did spell a pattern out both spelled a
different one. `agents/base.md` and `init.mjs` documented
`workshop-<slug>-local`; every one of the five repos actually used
`<slug>-workshop-local`, so the documented form had zero users. The template
scaffolded the documented form, which is how it would have reached the next
five-to-seven workshops.

The rule is now explicit: product slug, the literal `workshop`, then the target.
`ixp-workshop-growth`, `case-management-workshop-local`. The variable part goes
last so every app for one product sorts together. The old environment-first shape
(`growth-ixp-workshop`) is retired, and no new `staging` targets: the single
existing one predates the rule.

The slug budget survives unchanged at 15 characters, with cleaner arithmetic:
`-workshop-` spends 10 of 32, leaving 22 to share, and reserving 7 for the target
name caps the slug at 15. `init` no longer prints a `staging` row.

Not changed: `deriveCodedAppName` still produces `<productSlug>-<tenant>`, which
does not match this convention. It is inert -- no content repo sets
`productSlug`, so every target names itself explicitly -- and reshaping
derivation changes live URLs, so it belongs in the deliberate derived-names pass
rather than here. `base.md` now says so instead of leaving the two shapes to be
discovered as a contradiction.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@ThisIsTJ
ThisIsTJ merged commit be996ad into main Aug 28, 2026
1 check passed
@ThisIsTJ
ThisIsTJ deleted the feat/coded-app-name-convention branch August 28, 2026 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant