Skip to content

About

Reusable role contracts for the KUJO agent chain of command.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Kujo Agents

Version License built with Kujo

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.

Start Here

Read these files before running or adapting an agent set:

  1. chain-of-command/README.md — role selection, handoffs, model tiers, and campaign guidance.
  2. chain-of-command/00-chain-of-command.md — authority layers and escalation paths.
  3. chain-of-command/00-tool-agent-map.md — supported tool-to-role relationships.
  4. chain-of-command/general-commander/AGENT.md — top-level mission routing contract.
  5. webops/README.md — direct specialist selection, capabilities, permissions, history, and workflow composition.
  6. webops/00-agent-map.md — the complete WebOps roster.
  7. publishing-house/README.md — standalone operation, desks, review boundary, and current implementation scope.
  8. publishing-house/00-publishing-house.md — constitution, authority layers, productive tension, and interoperability rules.
  9. publishing-house/00-quality-standard.md — the premium editorial bar and generic-work warning signals.
  10. publishing-house/00-shared-contracts.md — briefs, evidence, artifacts, reviews, approvals, receipts, and handoffs.
  11. publishing-house/00-tool-workflow-map.md — canonical tool ownership, role bindings, and lifecycle workflow routing.
  12. publishing-house/evals/README.md — blind quality calibration, deterministic integrity checks, and semantic judging protocol.
  13. 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.

Repository Layout

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.

Canonical VideoOps tooling

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.

Release Status

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.

Validation

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 --check

License

MIT. See LICENSE.

About

Reusable role contracts for the KUJO agent chain of command.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages