Configuration and Copier Template Release Notes¶
These notes cover Copier template and configuration content changes
(template/, components/ / distribution/, and related harness base
settings). They are versioned with the shared v* release tags;
downstream populate pins and Copier template refs (_commit) all
follow v*.
They are not the emcd-agents / agentsmgr Python package changelog. Package release notes live in Release Notes and are managed with Towncrier.
Workflow (manual; no Towncrier for this file):
Authors add bullets under Unreleased with template or content changes (
template/,components//distribution/, harness base settings).Cutting a
v*release tag renames Unreleased to that tag and date (single tag line shared with the Python package; downstream Copier_commitrefs and populate pins all followv*).Do not file package Towncrier fragments for template-only work.
Pattern follows python-project-common
template-changelog.rst(manual sections).
Unreleased¶
(No entries.)
v1.0a20 (2026-11-14)¶
Curated consumer-facing summary of material configuration and template
changes since v1.0a19. Not a full commit history. No package code
changes in this release (see Release Notes).
Enhancements¶
Implementation-only task lists in the OpenSpec workflow: tasks.md carries implementation work, not review routing or publish steps; guardrail lines in the opsx-propose and opsx-apply skills.
Prerelease tag eligibility note in the runbook: a bare update resolves to HEAD while only alpha tags exist — use
--prereleasesor pin--vcs-refexplicitly.Update runbook moved out of the template tree to project documentation (read on GitHub, Sphinx-excluded); banners and the data-file header point at its URL instead of a tree path.
Session-reload rule: request operator reload of affected seats after coder-config changes take effect on disk.
Tracked vs populate-managed vs retired guidance for
coders/trees: commit template-rendered config, never stage managed trees or their exclusions, delete retired subtrees after rescuing unique content.Re-staged instructions from documentation-common (importlib stdlib retarget, Hatch-env delegation paragraph, neutral multi-template Copier section,
typestatements).Dogfood render of the template into this project (Clone Setup, bilateral reviews, uv formatter disable, env passthroughs).
v1.0a19 (2026-11-07)¶
Curated consumer-facing summary of material configuration and template
changes since v1.0a18. Not a full commit history.
Enhancements¶
Durable downstream update runbook: new
template/documentation/applying-template-updates.mdplus after-copy and after-update Copier banners pointing at it; the data file carries renamed answers only. Track the latest release by default; pin--vcs-refonly on explicit request. Copier 9.19.1 requires the data file as a local download (URL form no longer accepted); the runbook shows the download-first form.Clone Setupsection in the OpenSpec procedure: populate must run after any copy or update (creates theopenspecsymlink, harness symlinks, and MCP discovery links); warns that validate without the symlink exits 0 validating nothing.Bilateral reviews clause in the review procedure: author and active reviewer only, no Cc beyond the pair; integrator enters only at the merge request.
Agentmux environment passthroughs (
AGENTMUX_BUNDLE,AGENTMUX_SESSION,AGENTMUX_CONFIGURATION_DIRECTORY,AGENTMUX_STATE_DIRECTORYas${VAR:-}empty defaults) on the template agentmux MCP entry; no--bundleflag — bundle identity comes from the stamped server environment.Disable the uv formatter alongside ruff and prettier in the generated OpenCode settings (style-frozen repos were reformatted on every edit by the shared uv backend).
Hook install guidance prescribes the standalone uv-tool runner (per-user
pre-commitoutside any Hatch environment); hooks keep delegating via Hatch.Retired distributed content is delete-on-sight:
project-triagein per-coderskills/trees andpyright/librovoreMCP server entries lingering in old configurations.
Unreleased (historical accumulation)¶
Curated consumer-facing summary of material configuration and template
changes since agents-1.0. Not a full commit history.
Removals¶
Drop Gemini CLI and Qwen Code as supported template/distribution coders.
Stop shipping shared
architecture.rstinstruction and retire ADR-centriccs-architect-style commands from distribution content.Remove default blocking agent hooks from generated coder configuration.
Stop hiding managed coder resource directories behind ignore rules that blocked normal inspection of agentsmgr-managed trees.
Remove Claude
miscellany/bash-tool-bypassandmiscellany/command-template.mdfrom the Copier template.Retire distribution commands
cs-create-commandandcs-update-command.Remove obsolete Claude Code Web session setup notes (
documentation/miscellany/ccw-setup.md).Drop Copier answer
project_bundle_nameand stop passing Agentmux--bundlein generated MCP configs; Agentmux ≥0.9 injectsAGENTMUX_BUNDLEinto MCP children (lazy upgrade).
Enhancements¶
Hybrid layout:
components/sources render todistribution/viaagentsmgr generate(render and optional--checkstaleness). Copier template validation is separate and uses copiertv profiles.Populate installs Agent Skills packages (full directories with
SKILL.md/ scripts / references / assets, plus legacy flat*.md) under canonical.auxiliary/agents/skills/, links root.agents→.auxiliary/agents, and links each coderskills/directory to that tree (destructive cutover of legacy dual-copy skill dirs only; pre-existing real root.agentsis preserved).Rehome LM-facing operational guidance under
.auxiliary/agents/(entrypointagents.md, procedures, standards target). RootAGENTS.md/CLAUDE.mdremain thin memory symlinks into that tree.Split project-owned guidance into
.auxiliary/agents/project.md(Purpose / Tech Stack / Notes) with Copier_skip_if_existssocopier updatedoes not clobber local project knowledge. Generated entrypoint stays pointer-only.Retire distribution commands that restate staged standards or encode stale runbooks:
cs-code-python,cs-design-python,cs-conform-python,cs-excise-python,cs-conform-toml,cs-inquire,cs-plan-pytests,cs-develop-pytests,cs-copier-update,cs-document-examples-rst,cs-update-readme-rst,cs-annotate-release,cs-release-checkpoint,cs-release-final, andcs-release-maintenance. No distribution commands remain.Retire distribution subagents
python-annotatorandpython-conformer. They restated deleted command workflows.Keep empty
components/configurationsandcomponents/contentsin Git with an empty.gitignore.generaterequires those directories.Codify two-tier technical review in the template review procedure. Tier-1 Reviewer is the gate. Tier-2 Reviewer, usually an Advisor, is engaged only after Tier-1 approval. Authors must not dictate review scope or shotgun both tiers. Integrator handoffs name every engaged tier. OpenSpec proposal review follows that procedure. Agentmux
Ccis not a Tier-2 bypass. Handoff hygiene says coordination levels, not review tiers.OpenSpec procedure: a wording change sweeps
design.mdandproposal.md, not only the delta spec andtasks.md. Consulting the procedure does not authorize a proposal. Todo completion is the title checkbox, not a status tag.Default OpenCode
buildandplanagents tometa/muse-spark-1.3-contributor(Meta metered API, not a subscription or OpenCode Zen free tier).Stage
tests.mdandpractices-rust.mdfrompython-project-commondocs-1.9(82082295a30c9ef2aa4c633bc609df70c4a0e127) intodistribution/per-project/general/instructions/for populate. No header strip. This is an ingest slice, not retirement of the Copier instruction fetch.Default instructions target is
.auxiliary/agents/standards(replacing older instruction homes); instruction sync copies from distribution general instructions into that target.OpenSpec 1.5 / OPSX skills and template guidance (
opsx-*skill names without custom prefix); OpenSpec scaffolding remains underdocumentation/architecture/openspec/with managed rootopenspecsymlink for tooling that expects./openspec.nb MCP and OpenSpec workflow guidance live in template procedures under
.auxiliary/agents/procedures/rather than only inlined in the entrypoint.Delegated review / handoff / collaboration guidance in shared AGENTS operation text (reviewer vs integrator, fixup hold until approve, base-advance re-review, harness-safe autosquash inspect).
agentmux MCP support and project bundle-name templating in Copier answers / MCP sets.
Claude project MCP server allowlisting for standard project MCP set.
OpenCode generated resource directories use plural names aligned with other coders.
Cross-harness shell allowlists expanded for common read-oriented and development commands; Claude, OpenCode, and Codex harness-level allowlists permit
readlinkandtest(argument forms only).Cross-harness shell allowlists permit
date,printf,set,sleep,stat, anduname. Bare forms are included where the bare command is the common invocation (date,uname);cdneeds no entry since OpenCode never prompts for directory changes.Single-source staged instructions from
documentation-common(immutablev1.0.3):distribution/.../instructions/holds 21 Markdown guides with license headers stripped; 16 legacy.rsttranslations intentionally deleted. Theinstructions_sourcesmap is removed from Copier template defaults, test profiles, and answers (populate never consulted it); per-language selection lives in the template entrypoint reference list. Theprovide_instructionsboolean is removed: instructions are always provisioned (small, git-excluded footprint), so former opt-outs receive standards on their next populate.Codex Starlark rules allowlist (including selected git write prefixes such as commit/tag) and approval routing defaults suitable for trusted local development.
Rolling handoff hygiene lives in
.auxiliary/agents/procedures/notebook.mdonly (no AGENTS section). Coordinators/sole owners and tech leads (for their lanes) own handoffs; implementers do not. No routine post-commit handoff refreshes.Delegated review: post-approval rebase onto an advanced base may use a merge handoff when the stack is byte-identical and the author re-runs lints/tests; non-identical stacks still require technical re-review. Integrator retains merge-safety checks across lanes.
Language-aware instruction defaults (e.g. Rust) in Copier answers maps.
Template validation migrated to copiertv profiles under
.auxiliary/configuration/copiertv/.
Notices¶
Configuration pins (Copier
_commitrefs) and the sharedv*release tag line cover template, configuration, and package together; installed-package versus template-pin choices remain independent. (Historical note: a singleagents-1.0tag was cut in 2025 for the initial configuration data release; all releases since have usedv*. Package CLI changes are documented only in Release Notes.)Self-dogfood of template changes uses
copier updateagainst a reachable template ref, thenagentsmgr generate/populateas needed — do not hand-mirrortemplate/into live project paths.Intermediate OpenSpec home relocation is not a supported migration step; future Nbspec cutover is tracked separately from this changelog track.
agents-1.0 (2025-10-22)¶
Enhancements¶
Initial agent configuration data release with relative path support for populate sources.