kob

Public behavior kit for ai4X agent portfolio ownership and cognitive bundle curation.

kob owns the public agent portfolio under agn/ and the authored cognitive bundle surfaces under agn/**/ccc/. It provides the public wrapper CLI under utl/kob/ for curating, updating, and validating those bundles.

kob does not own the generic cognitive compose, graph, materialization, cleanup, or bundle-doctor engine. That shared suite responsibility lives in ccm. kob consumes ccm and keeps ownership of:

• public agent roots under agn/
• authored cap.compose.yaml and authored local ccc/*.md plus .meta.yaml
• public portfolio validation (AGENTS.md, ccc/, frontmatter discipline)
• source-ref update behavior such as kob cap update --source <key> --ref <ref>
• operator-facing CLI UX and deterministic wrapper output

kob also includes a dedicated agn/architecture/* portfolio for TOGAF-aligned chief, enterprise, domain, and solution architecture agents. Those agents keep their TOGAF-native base in ccp/cap/architecture/*; any added AI capabilities come only from ccp/cap/ai/architecture/* and only at agent-bundle level.

kob follows the ai4X agent-first development model.

Consequences:

• deterministic checks are handled through wrapper CLI gates, portfolio validation, and verify
• higher-order review, handover, planning, and capability-quality governance belong to root ai4X when kob is evolved inside the ai4X suite context
• therefore:
  • doc/usr/* is the direct human-facing documentation surface
  • doc/agn/* is the agent-facing onboarding and navigation surface
  • doc/arc/* is module architecture and structure documentation
  • local adm/dev/* is module-specific governance and normative technical reference
  • local adm/ops/* is module-specific operations documentation
• kob remains a domain-owning repository, but ai4X is the governing suite context when kob is used or evolved inside ai4X¹
• that matters in practice because:
  • kob curates public behavior surfaces without re-owning the generic cognitive bundle engine.
  • Mechthild provides need-first curation for high-quality project-local agents instead of ad hoc prompt assembly.
  • staged local-agent materialization avoids half-built agent roots in project workspaces.
  • public bundle curation and local agent generation stay governed but composable.

For Humans

Copy and paste this prompt to your LLM agent. Do not just read it yourself; let your agent explain ai4X to you:

Guide me through kob as a newcomer by following these sources in order:
1. https://raw.githubusercontent.com/normenmueller/kob/trunk/doc/agn/user-onboarding.md
2. https://raw.githubusercontent.com/normenmueller/kob/trunk/doc/usr/primer.md
3. https://raw.githubusercontent.com/normenmueller/kob/trunk/INSTALL
4. https://raw.githubusercontent.com/normenmueller/kob/trunk/utl/kob/README.md
5. https://raw.githubusercontent.com/normenmueller/kob/trunk/agn/curation/mechthild/doc/primer.md
Then explain what kob owns, how curated public agents differ from project-local agent curation, why Mechthild matters, and which first hands-on path fits my goal best.

For Agents

Use this bootstrap prompt when entering kob from a local checkout or from GitHub:

You are entering the kob repository for governed work.
If you have a local checkout, use the local equivalents of these sources. Otherwise fetch them directly:
1. https://raw.githubusercontent.com/normenmueller/kob/trunk/AGENTS.md
2. https://raw.githubusercontent.com/normenmueller/kob/trunk/CONTRIBUTING.md
3. https://raw.githubusercontent.com/normenmueller/kob/trunk/INSTALL
4. https://raw.githubusercontent.com/normenmueller/kob/trunk/doc/agn/maintainer-onboarding.md
5. https://raw.githubusercontent.com/normenmueller/kob/trunk/doc/agn/source-map.md
If the work is inside the ai4X suite context, also load:
- https://raw.githubusercontent.com/normenmueller/ai4x/trunk/AGENTS.md
- https://raw.githubusercontent.com/normenmueller/ai4x/trunk/adm/dev/protocols/workflow.md
Then summarize the public portfolio structure, the split between kob and ccm, tell me which local or ai4X protocol applies to the current task, and do not infer workflow from repository layout alone.

Documentation

• module architecture: doc/arc/arc42.md
• wrapper utility: utl/kob/README.md
• shared cognitive bundle contract in ai4X suite context: ../../adm/dev/contracts/cognitive-compose.md

License

See LICENSE. © 2026 nemron

Footnotes

1. #eyodf = "eat your own dog food". kob is maintained with the same agent-first model it helps execute. ↩