Reusable role contracts for KUJO agent sets.
The public repository contains four independent first-class packages:
chain-of-command/— coordinated roles for strategy, planning, execution, verification, knowledge, and bounded worker tasks.webops/— 28 peer website operators for research, measurement, audit, maintenance, optimization, and improvement.publishing-house/— 23 editorial roles for strategy, creative development, writing, independent review, production, approval packaging, and bounded publishing operations.videoops/— one production coordinator and five bounded video-production specialists for planning, asset resolution, media generation, HyperFrames editing, and independent critique.
Read these files before running or adapting an agent set:
chain-of-command/README.md— role selection, handoffs, model tiers, and campaign guidance.chain-of-command/00-chain-of-command.md— authority layers and escalation paths.chain-of-command/00-tool-agent-map.md— supported tool-to-role relationships.chain-of-command/general-commander/AGENT.md— top-level mission routing contract.webops/README.md— direct specialist selection, capabilities, permissions, history, and workflow composition.webops/00-agent-map.md— the complete WebOps roster.publishing-house/README.md— standalone operation, desks, review boundary, and current implementation scope.publishing-house/00-publishing-house.md— constitution, authority layers, productive tension, and interoperability rules.publishing-house/00-quality-standard.md— the premium editorial bar and generic-work warning signals.publishing-house/00-shared-contracts.md— briefs, evidence, artifacts, reviews, approvals, receipts, and handoffs.publishing-house/00-tool-workflow-map.md— canonical tool ownership, role bindings, and lifecycle workflow routing.publishing-house/evals/README.md— blind quality calibration, deterministic integrity checks, and semantic judging protocol.videoops/README.md— the file-handoff production line, model routing, permissions, stage gates, and offline proof boundary.
For a reusable campaign intake packet, use
chain-of-command/00-docs/templates/general-campaign-wrapper.md.
CHANGELOG.md
VERSION
chain-of-command/
README.md
00-chain-of-command.md
00-tool-agent-map.md
00-ecosystem-inventory.md
00-docs/
agent-name/
AGENT.md
SKILL.md
webops/
README.md
00-agent-map.md
00-tool-agent-map.md
00-capability-integration-map.md
00-permission-model.md
00-history-and-reporting.md
00-workflow-map.md
webops-catalog.json
agent-name/
AGENT.md
SKILL.md
publishing-house/
README.md
00-publishing-house.md
00-quality-standard.md
00-shared-contracts.md
00-permission-model.md
00-agent-map.md
00-tool-workflow-map.md
publishing-house-catalog.json
evals/
README.md
quality-rubric.json
evaluation-manifest.json
judge-prompt.md
judge-output.schema.json
eval.json
cases/
expected/
agent-name/
AGENT.md
SKILL.md
agents/openai.yaml
videoops/
README.md
00-agent-map.md
00-production-standard.md
00-hyperframes-standard.md
00-permission-model.md
00-model-routing.md
00-handoff-and-state.md
videoops-catalog.json
agent-name/
AGENT.md
SKILL.md
Each agent package keeps its role contract and operating skill together. The templates are guidance and review material; they do not provide sandboxing, authorization, or policy enforcement by themselves.
Every role also includes a provider-neutral manifest.json,
input.schema.json, and output.schema.json. The complete package format and
credential-free Hermes/Paperclip renderers are documented in
docs/agent-package-format.md.
The checked-in agent-registry.json indexes all 85
roles. Rebuild it and the role package files with
python3 scripts/generate_agent_manifests.py, then validate them with
python3 scripts/validate_agent_packages.py.
The VideoOps team and its executable media, audio QA and review tools live together in this repository. Use videoops/tools/README.md for setup and commands. The retired standalone kujo-videoops repository is not a runtime or schema dependency. See migration history.
v1.5.0 brings executable media-provider, source-aware audio QA, and exact-candidate
review tools into the canonical VideoOps agent package while preserving Chain of Command,
WebOps, and Publishing House. The Producer routes speech, sound effects and
music through the capability-specific adapters in videoops/tools, with local
import, scoped operator authorization, provenance receipts and explicit cost
bounds. Missing playback or listening capability routes to human review;
it does not consume editor repair cycles.
Start with videoops/00-media-toolchain.md
and the versioned VideoOps toolchain contract.
These packages provide portable role guidance and synchronized schemas. The
runtime enforces dispatch boundaries; HyperFrames owns editing and mixing.
Provider implementation and mocked tests do not establish live access or rights
for every capability. Account-specific live verification belongs in runtime
receipts, and successful generation never grants audiovisual approval.
See CHANGELOG.md for release history and
docs/launch-checklist.md for the verified release
scope.
find chain-of-command -mindepth 2 -maxdepth 2 -type f \
\( -name AGENT.md -o -name SKILL.md \) | sort
for dir in chain-of-command/*/; do
case "$dir" in
chain-of-command/00-docs/) continue ;;
esac
test -f "${dir}AGENT.md" && test -f "${dir}SKILL.md"
done
bash .github/scripts/check-kujo-tool-artifacts.sh
python3 scripts/validate_webops.py
python3 scripts/validate_publishing_house.py
kujo run scripts/validate_videoops.kujo
python3 scripts/validate_agent_packages.py
bash videoops/tools/tests/run.sh
test "$(cat VERSION)" = "1.5.0"
git diff --checkMIT. See LICENSE.