Back to the catalog

Agent OS Knowledge

Bundle OKF 0.1 · 19 conceitos · amitkarpe/agent-os

Open source Repository Open in the app JSON README (API)

About

# Agent OS Knowledge

## Start by task

- **Learn, apply, and contribute safely:** [Using Agent OS with Task-Scoped Context](playbooks/knowledge/using-agent-os-task-scoped.md) - Learn from the KB, apply one to three matching concepts, and suggest sanitized candidates without overriding project authority.
- **Run a controller or recover a session:** [Agent Operating Principles](principles/amit-agent-operating-principles.md), [Persistent Codex Goals](playbooks/codex/persistent-goals.md), and [Named Session Reuse](playbooks/codex/named-session-reuse.md).
- **Delegate work or supervise completion:** [Controller-Worker Goal Execution Framework](playbooks/delegation/controller-worker-goal-execution-framework.md), [Codex Native Controller-Worker Protocol](playbooks/delegation/codex-native-controller-worker-protocol.md), [Effective Subagent Delegation](playbooks/delegation/effective-subagent-delegation.md), [Completion Notification without Polling](playbooks/delegation/completion-notification-

Details

Kind
OKF bundles
Topic
No topic detected
Publisher
amitkarpe
Origin
okf_github
Category
dados
Version
0.1
Last push
2026-09-08T02:24:47Z
Repository state
ativo
Language
Shell
License
Apache-2.0
Added
2026-09-09 12:02:17
Updated
2026-09-09 12:02:17
Origin id
amitkarpe/agent-os:kb/index.md

README

# Agent OS

Agent OS is a public knowledge bundle of concise operating principles,
policies, playbooks, practices, patterns, and dated observations for agentic
work.

The repository uses Markdown as its canonical format. Content under [`kb/`](kb/)
targets [Open Knowledge Format 0.1](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).

## Use

Start with the [knowledge index](kb/index.md). Treat policies and principles as
stable guidance, playbooks as repeatable procedures, and observations as dated
evidence that may need retesting.

Agents should use the [task-scoped usage guide](kb/playbooks/knowledge/using-agent-os-task-scoped.md)
to load only the concepts relevant to the current task.

For controller-worker execution, use the
[Fast Goal and Deep Goal framework](kb/playbooks/delegation/controller-worker-goal-execution-framework.md):
Fast is the default, and Deep is reserved for genuinely risky or complex work.

## Universal Onboarding Prompt

```text
Learn from Agent OS before continuing.

Agent OS source: <AGENT_OS_ROOT, configured workspace, or public Agent OS URL>
Active project: <active-project-root or repository context>
Task: <task>

Learn: Locate the configured clone through AGENT_OS_ROOT or workspace discovery.
If it is unavailable, use the public Agent OS knowledge base. Read Agent OS
AGENTS.md, README.md, and kb/index.md first.

Apply: Choose the matching task route and load only one to three relevant
concepts. Briefly state what applies, what does not apply, and any conflict. The active
project's instructions, SPEC, approvals, and safety policy remain authoritative.
Apply the useful guidance to planning and execution.

Contribute: At closeout, name the Agent OS concepts used and suggest reusable
learning as a sanitized candidate. Do not publish private runtime truth or
modify Agent OS unless explicitly asked.
```

Validate a checkout with:

```bash
scripts/validate.sh
```

Run the validator's focused pass/fail checks with:

```bash
scripts/validate.sh --self-test
```

GitHub Actions validates pushes and pull requests. After the workflow is pushed,
the repository owner must select **GitHub Actions** as the Pages source if it is
not already enabled.

## License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE).

More