Publish bundle

publish_bundle

Packs a CE_RD_OS workstream output into the dual-track delivery format.

Two artifacts from one source of truth

The repo IS the source of truth. The zip is generated from the repo.

Track A1: GitHub repo

• The repo at the user's GitHub remote (default https://github.com/<handle>/ce-rd-os).
• AGENTS.md at root, conformant to the AGENTS.md spec.
• 6 SKILL.md files under skills/, each conformant to agentskills.io.
• references/ folder with the 10 supporting documents.
• LICENSE (Apache-2.0), LICENSE-DOCS (CC-BY-4.0), CHANGELOG.md (Keep a Changelog 1.1.0), NOTICES.md, CONTRIBUTING.md.
• Makefile, registry.yaml, authors.yaml, .gitignore.
• .github/workflows/{verify.yml, release.yml}.
• packets/ for vendored release artifacts and PROCEED.md.
• scripts/ for verify_self.sh and pack_text_bundle.sh.

Track A2: 10-file text zip

Generated by scripts/pack_text_bundle.sh. Contents:

1. AGENTS.md
2. README.md
3. SETUP.md
4. system_directive.md (extracted from skills/system_directive/SKILL.md)
5. setup_intake.md
6. source_ingestion.md
7. trinity_rubric.md
8. workstream_creator.md
9. publish_bundle.md
10. PROCEED.md

The zip drops into NotebookLM, Claude project, custom Gem, custom GPT. The host reads AGENTS.md first, then runs setup_intake from setup_intake.md, then proceeds through the workstreams.

Publish-readiness rubric (15 row matrix)

The publish_bundle skill maintains a 15-row publish-readiness matrix that scripts/verify_self.sh executes mechanically.

#	Tag	Check
1	Essential	AGENTS.md exists at repo root
2	Essential	each SKILL.md frontmatter validates
3	Essential	skill name field equals parent directory name
4	Essential	description length 1 to 1024
5	Essential	LICENSE recognized header (Apache-2.0)
6	Essential	no em or en dashes anywhere
7	Essential	no privacy blocklist hits
8	Important	CLAUDE.md and GEMINI.md are 3-line pointers
9	Important	CHANGELOG.md has [Unreleased] and [0.X.Y] sections
10	Important	registry.yaml rows match skills tree
11	Important	git config user.email is not a system default
12	Optional	compatibility lists 3 or more host envs
13	Optional	reference docs follow progressive disclosure
14	Pitfall	no eager multi-body load (no skill imports another's body)
15	Pitfall	no reference doc body over 5000 lines

verdict: PROMOTE if all Essential pass and no Pitfall fails. verdict: HOLD otherwise.

Procedure

The skill walks these steps in order. Steps stop on first failure.

1. Read setup configuration from the active workstream.
2. Run verify_self.sh. If exit non-zero, surface failures to the architect, do not proceed.
3. Run pack_text_bundle.sh. Produces dist/ce-rd-os-vX.Y.Z-text-bundle.zip.
4. Generate SHA-256 sidecar for the zip.
5. Fill approval_gate template at build/APPROVAL_GATE_TEMPLATE.md. Sections 1 through 5 are filled by the agent honestly. Section 6 (architect verdict) is left blank.
6. Surface to architect. Wait for verdict.
7. On APPROVED verdict only: tag the release (git tag -a vX.Y.Z), push, run gh release create (or rely on the release.yml workflow triggered by the tag).
8. On REVISIONS verdict: implement fixes, return to step 2.
9. On REJECTED verdict: package state into HANDOFF_PACKET_v2.md, surface to architect, stop.

Architect-only verdict

The agent fills the approval gate but does not issue the verdict. The architect issues the verdict via the section 6 / 7 of the template at build/APPROVAL_GATE_TEMPLATE.md.

This is a hard rule. No agent ever auto-promotes a release.

Multi-bundle reuse

This skill works for any CE_RD_OS-shaped bundle, not just CE_RD_OS itself. The Makefile and scripts can be vendored into adjacent bundles (the user's other product tracks) by:

1. Copying the bundle skeleton (AGENTS.md, registry.yaml, authors.yaml, Makefile, scripts/, .github/workflows/).
2. Replacing skill bodies with the new bundle's skills.
3. Updating registry.yaml entries.
4. Updating CHANGELOG.md, NOTICES.md, README.md.
5. Running verify_self.sh against the new bundle.

The user has indicated other product tracks will use this same publish flow. The skill is built for that.

Citations

• AGENTS.md spec, Linux Foundation Agentic AI Foundation.
• Agent Skills spec, Anthropic, agentskills.io.
• Keep a Changelog 1.1.0, keepachangelog.com.
• Conventional Commits 1.0, conventionalcommits.org.
• SemVer 2.0.0, semver.org.
• The vercel-labs zip-filename-equals-directory-name convention.
• The openai-cookbook and anthropics/claude-cookbooks registry.yaml schema.

End publish_bundle.