BWOC Handbook — Sitemap¶
This file is the human-readable and machine-parseable corpus inventory for the BWOC Handbook. It is intended for use by web crawlers, documentation indexers, and RAG ingestion pipelines as a crawl-queue seed list.
Paths are site-root-relative (e.g. /end-user/HANDBOOK.en.md).
Operators: substitute your deployed host to produce absolute URLs.
For allow/deny crawl rules see robots.txt.
For AI/RAG ingestion hints see ai-search/HANDBOOK.en.md.
For the full freshness-signal spec see crawler/HANDBOOK.en.md.
Handbook corpus — by role¶
Entry points¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/README.md |
English | Yes | Role-routing entry point for all readers; introduces the five handbook roles, the lifecycle model, and fast-path commands. |
/README.th.md |
Thai | Parity of /README.md |
Thai-language entry point; identical structure to the English version; maintained in parity. |
Summary — /README.md: The single entry point for the entire handbook. Presents a routing table (end-user, developer, agent author, AI-search agent, crawler), explains the BWOC framework in five sentences, describes the three-phase lifecycle (birth / live / retire), and states the cross-cutting conventions (bilingual-English-primary, no local path links, version pinning). High authority; changes infrequently.
Summary — /README.th.md: Exact Thai-language counterpart of README.md. Routing table and all sections are kept in parity. Index as hreflang="th" with canonical README.md.
End-user handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/end-user/HANDBOOK.en.md |
English | Yes | Install, workspace setup, and all CLI interactions for users who run agents without touching framework code. |
/end-user/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the end-user handbook. |
Summary — /end-user/HANDBOOK.en.md: Covers the complete end-user journey: Rust/CLI installation and bwoc doctor, workspace creation, four ways to drive an agent (chat, run, spawn, send), backend overrides, inbox/log/memory/health commands, team (Sangha) creation and shared task-list management, the agent lifecycle commands (new, stop, start, retire, check), fleet overview (dashboard, sessions, fleet, peer), document scaffolding (notes, retro, research), update and shell completion, and a troubleshooting table. Cross-references the agents and developer handbooks.
Summary — /end-user/HANDBOOK.th.md: Thai-language parity of /end-user/HANDBOOK.en.md. All ten sections are maintained in parity. Index as hreflang="th" with canonical /end-user/HANDBOOK.en.md.
Developer handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/developer/HANDBOOK.en.md |
English | Yes | Crate map, build/test procedures, hooks, versioning policy, release recipe, and PR gates for framework contributors. |
/developer/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the developer handbook. |
/plugin-craft/HANDBOOK.en.md |
English | Yes | Plugin authoring: kinds, manifest, lifecycle, schemas, the write-verb gate. |
/plugin-craft/HANDBOOK.th.md |
Thai | Parity | Thai parity of the plugin-authoring chapter. |
Summary — /developer/HANDBOOK.en.md: Guides contributors who work on the Rust framework itself. Covers the three-crate workspace (bwoc-core, bwoc-cli, bwoc-agent, bwoc-deep-memory), build and test commands, the auto-version hook that stamps VERSION.md on every edit, the dual versioning namespace (Cargo SemVer for development checkpoints; CalVer tags for public releases), the protected-branch PR discipline (four CI gates, auto-merge, one-concern-per-PR), bilingual parity rules, and implementation note conventions in notes/.
Summary — /developer/HANDBOOK.th.md: Thai-language parity of /developer/HANDBOOK.en.md. Index as hreflang="th" with canonical /developer/HANDBOOK.en.md.
Why BWOC / Philosophy handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/philosophy/HANDBOOK.en.md |
English | Yes | The design-rationale chapter — why BWOC, its pillars, the 22-framework engineering↔dhamma mapping, and why to adopt it. |
/philosophy/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the philosophy chapter. |
Summary — /philosophy/HANDBOOK.en.md: Explains BWOC's design and reasoning: the four pillars, where mainstream frameworks (DDD/SOLID/Clean) fall short for agent systems, the full 22-Buddhist-framework→engineering mapping table, the five governing principles, the uppāda·ṭhiti·vaya lifecycle, who should/should not adopt it, and design tradeoffs. States plainly that Pali terms are engineering labels, not religious instruction. Index as canonical.
Summary — /philosophy/HANDBOOK.th.md: Thai-language parity of /philosophy/HANDBOOK.en.md. Index as hreflang="th" with canonical /philosophy/HANDBOOK.en.md.
Self-improvement handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/self-improvement/HANDBOOK.en.md |
English | Yes | How a BWOC agent learns, reflects, and improves — learning loop, memory tiers, curation pipeline, maturity, and metrics. |
/self-improvement/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the self-improvement chapter. |
Summary — /self-improvement/HANDBOOK.en.md: Capability declaration and skill maturity L1–L7; the three ways an agent learns (study/reflection/practice) and the memory artifacts each writes; the Wisdom Loop; the curation pipeline from personal note to fleet convention; memory tiers with every bwoc memory command; the work engine and effort discipline; the growth lifecycle; metrics, anti-patterns, and learning triggers. Index as canonical.
Summary — /self-improvement/HANDBOOK.th.md: Thai-language parity of /self-improvement/HANDBOOK.en.md. Index as hreflang="th" with canonical /self-improvement/HANDBOOK.en.md.
Agent author / operator handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/agents/HANDBOOK.en.md |
English | Yes | Agent directory layout, the AGENTS.md rule, slot system, manifest schema, backend-neutrality validation, and the full agent arc. |
/agents/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the agent handbook. |
Summary — /agents/HANDBOOK.en.md: The definitive guide for incarnating, tuning, and operating BWOC agents. Explains the agents/agent-<name>/ directory structure, the five slot directories (persona/, mindsets/, skills/, interconnect/, memories/), the AGENTS.md symlink pattern (all backends link to one file), config.manifest.json schema, the {{camelCase}} placeholder rule for backend neutrality, bwoc check audit, the MEMORY.md 200-line discipline, team membership via .bwoc/teams/<team>.toml, and the lifecycle CLI commands. Also covers Obsidian-format slot files vs. plain-Markdown instruction files.
Summary — /agents/HANDBOOK.th.md: Thai-language parity of /agents/HANDBOOK.en.md. Index as hreflang="th" with canonical /agents/HANDBOOK.en.md.
Persona · Mindsets · Skills (slots) handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/slots/HANDBOOK.en.md |
English | Yes | How to write an agent's slot content — persona (WHO), mindsets (HOW), skills (WHAT) — with frontmatter, tags, and maturity levels. |
/slots/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the slots handbook. |
Summary — /slots/HANDBOOK.en.md: The craft of authoring slot files. Covers the WHO/HOW/WHAT framing, the Obsidian slot format (frontmatter + wikilinks + callouts) versus the plain AGENTS.md rule, persona (Identity/Primary Role/Core Principles), mindsets (principle/<pali> tag, When/How-to-Apply), skills (domain/<area> tag + maturity: L1–L7, Domain/Inputs/Outputs), the Thai-body/English-tags/emoji convention, seeding with bwoc new --mindsets/--skills, and bwoc check. Index as canonical.
Summary — /slots/HANDBOOK.th.md: Thai-language parity of /slots/HANDBOOK.en.md. Index as hreflang="th" with canonical /slots/HANDBOOK.en.md.
Backends handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/backends/HANDBOOK.en.md |
English | Yes | Drive & configure an agent through each backend CLI (Claude/AGY/Codex/Kimi/Copilot/Ollama/OpenAI-compatible) by prompt, after bwoc init. |
/backends/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the backends handbook. |
Summary — /backends/HANDBOOK.en.md: How to use and configure agents through any backend CLI once a workspace is initialised and agents are incarnated. Covers the AGENTS.md + symlink mechanism, vendor agentic CLIs (Claude Code, Antigravity agy, Codex, Kimi, GitHub Copilot) vs harness backends (Ollama, OpenAI-compatible needing baseUrl), launching via bwoc spawn/chat/run with --backend, configuring by natural-language prompt, persisting config in config.manifest.json + bwoc check, and adding a backend with one symlink. Index as canonical.
Summary — /backends/HANDBOOK.th.md: Thai-language parity of /backends/HANDBOOK.en.md. Index as hreflang="th" with canonical /backends/HANDBOOK.en.md.
AI search / RAG handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/ai-search/HANDBOOK.en.md |
English | Yes | Chunking hints, citation format, authoritative-source hierarchy, and hallucination warnings for AI/RAG pipelines ingesting this corpus. |
/ai-search/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the AI-search handbook. |
Summary — /ai-search/HANDBOOK.en.md: Written for LLM-based retrieval agents and RAG pipelines rather than traditional web spiders. Provides a curated fetch order optimized for LLM context windows, a canonical source-of-truth hierarchy (framework repo beats handbook), specific hallucination warnings (e.g., do not invent CLI flags; always cite VERSION.md for version claims), recommended citation format, and guidance on which pages to weight most heavily for question-answering tasks.
Summary — /ai-search/HANDBOOK.th.md: Thai-language parity of /ai-search/HANDBOOK.en.md. Index as hreflang="th" with canonical /ai-search/HANDBOOK.en.md.
Crawler / indexer handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/crawler/HANDBOOK.en.md |
English | Yes | Crawl scope table, bilingual canonical structure, freshness signals, polite-crawl guidelines, and pointers to robots.txt and sitemap.md. |
/crawler/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the crawler handbook. |
Summary — /crawler/HANDBOOK.en.md: Authoritative crawl policy document. Contains an exhaustive two-column index-vs-skip table covering every path pattern in both the handbook corpus and the framework repo, the bilingual hreflang declaration scheme, the freshness-signal spec (where Software-Version, Document-Version, and Last-Updated live and how the auto-version hook maintains them), recommended re-crawl cadences, polite-crawl requirements (honor robots.txt, Crawl-delay: 10, conditional GET, User-agent identification), and the linking policy (public GitHub URLs for framework source; relative paths within the handbook).
Summary — /crawler/HANDBOOK.th.md: Thai-language parity of /crawler/HANDBOOK.en.md. Index as hreflang="th" with canonical /crawler/HANDBOOK.en.md.
Ecosystem / projects handbook¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/ecosystem/HANDBOOK.en.md |
English | Yes | Maps every BWOC and related bwoc-* project — core framework, desktop/menu-bar apps, and device targets — with each project's stack and how it connects to the core. |
/ecosystem/HANDBOOK.th.md |
Thai | Parity | Thai-language parity of the ecosystem handbook. |
Summary — /ecosystem/HANDBOOK.en.md: A single page mapping the BWOC family: the core framework + bwoc CLI, bwoc-chat (egui desktop chat), bwoc-devices (portable Rust device core + ESP32 firmware), bwoc-devices-app / BWOC Monitor (Tauri macOS dashboard), bwoc-llm-pm / LLM Provider Monitor (macOS menu-bar), bwoc-mcc (SwiftUI menu-bar control center), and this handbook. Each entry gives the stack and how it connects to the CLI/shared protocol. Index as canonical; links to public GitHub repos only.
Summary — /ecosystem/HANDBOOK.th.md: Thai-language parity of /ecosystem/HANDBOOK.en.md. Index as hreflang="th" with canonical /ecosystem/HANDBOOK.en.md.
Quickstart¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/quickstart/HANDBOOK.en.md |
English | Yes | Guided ~10-minute end-to-end tutorial from install to first agent and retire. |
/quickstart/HANDBOOK.th.md |
Thai | Parity | Thai parity of the quickstart. |
Single-agent workspace¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/single-agent/HANDBOOK.en.md |
English | Yes | When/how to run a one-agent workspace (bwoc init --single-agent) vs the fleet. |
/single-agent/HANDBOOK.th.md |
Thai | Parity | Thai parity of the single-agent chapter. |
Security & tianting team¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/security/HANDBOOK.en.md |
English | Yes | Threat model, Five Precepts, signed inter-agent trust, and the 8-agent tianting security team. |
/security/HANDBOOK.th.md |
Thai | Parity | Thai parity of the security chapter. |
Cross-workspace & protocols¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/cross-workspace/HANDBOOK.en.md |
English | Yes | bwoc peer, the A2A protocol, and MQTT transport over signed envelopes. |
/cross-workspace/HANDBOOK.th.md |
Thai | Parity | Thai parity of the cross-workspace chapter. |
Self-hosting (Harness)¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/harness/HANDBOOK.en.md |
English | Yes | Running agents on Ollama / OpenAI-compatible via bwoc-harness. |
/harness/HANDBOOK.th.md |
Thai | Parity | Thai parity of the harness chapter. |
Fleet operations¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/fleet-ops/HANDBOOK.en.md |
English | Yes | Running many agents at scale: fleet health, supervise, sessions, doctor. |
/fleet-ops/HANDBOOK.th.md |
Thai | Parity | Thai parity of the fleet-ops chapter. |
/council/HANDBOOK.en.md |
English | Yes | Structured fleet decisions: the council protocol, voting models, the decision record. |
/council/HANDBOOK.th.md |
Thai | Parity | Thai parity of the council chapter. |
FAQ & troubleshooting¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/faq/HANDBOOK.en.md |
English | Yes | Common questions + a symptom→cause→fix troubleshooting table. |
/faq/HANDBOOK.th.md |
Thai | Parity | Thai parity of the FAQ chapter. |
Chat Connectors (Telegram & Discord)¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/connect/HANDBOOK.en.md |
English | Yes | Bring a BWOC agent into Telegram & Discord via the bwoc-connect crate (long-poll/gateway, DM+group, keyring secrets, daemon-supervised). |
/connect/HANDBOOK.th.md |
Thai | Parity | Thai parity. |
Google Workspace¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/google-workspace/HANDBOOK.en.md |
English | Yes | Connect BWOC to Google Workspace via the gws plugin family (auth/drive/gmail/calendar; install/enable, scoped read-mostly ops). |
/google-workspace/HANDBOOK.th.md |
Thai | Parity | Thai parity. |
Jira & SCRUM¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/jira-scrum/HANDBOOK.en.md |
English | Yes | Jira & SCRUM: the jira-cloud-rest plugin (kind jira, project-scoped JQL + gated transitions) + the scrum-via-jira skill (sprint verbs); kind-dependency model. |
/jira-scrum/HANDBOOK.th.md |
Thai | Parity | Thai parity. |
ISO Standards Audit¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/iso-audit/HANDBOOK.en.md |
English | Yes | Machine-assisted ISO audits via audit-kind plugins (ISO 9001/27001/20000-1/29110): attestations + SoA + samples, read-only findings. |
/iso-audit/HANDBOOK.th.md |
Thai | Parity | Thai parity. |
OKR Plugin¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/okr/HANDBOOK.en.md |
English | Yes | Manage OKRs in BWOC via the okr plugin (objectives/key-results in local TOML; track / check-progress / report verbs; ties to fleet governance). |
/okr/HANDBOOK.th.md |
Thai | Parity | Thai parity. |
Glossary¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/glossary.en.md |
English | Yes | Authoritative definitions of all specialized BWOC terms; linked from every handbook page on first use. |
/glossary.th.md |
Thai | Parity | Thai-language parity of the glossary. |
Summary — /glossary.en.md: The single reference for BWOC vocabulary. Defines terms from both the engineering layer (workspace, agent, slot, manifest, backend-neutrality, trust level, Sangha, harness) and the philosophy layer (uppāda, ṭhiti, vaya, yoniso manasikāra, mattaññutā, anattā, samānattatā, sīlasāmaññatā). Every definition includes a plain-English explanation and a cross-reference to the framework concept it encodes. Stable; changes rarely.
Summary — /glossary.th.md: Thai-language parity of /glossary.en.md. Term entries are in parity; all definitions are maintained together. Index as hreflang="th" with canonical /glossary.en.md.
Ancillary files¶
| Path | Language | Canonical? | One-line description |
|---|---|---|---|
/llms.txt |
English | Yes | Plain-text LLM entry point; compact corpus summary optimized for LLM context-window ingestion. |
/sitemap.md |
English | Yes | This file — human+machine corpus map with descriptions and canonical framework doc links. |
Summary — /llms.txt: A compact, plain-text file following the llms.txt convention. Provides a structured summary of the entire handbook corpus in a format optimized for direct ingestion into LLM context windows. Lists the most authoritative pages in priority order, states the source-of-truth hierarchy, and provides the key framework URLs. AI pipelines should fetch this file first before deciding which detailed pages to retrieve.
Summary — /sitemap.md: This file. Provides a grouped, role-organized inventory of every indexable handbook page and every canonical framework doc, with site-root-relative paths, language tags, canonical flags, one-line descriptions, and one-paragraph summaries. Intended as the crawl-queue seed list for web indexers and as a quick navigation aid for human readers.
Canonical framework docs¶
These files are hosted in the public bemindlabs/BWOC-Framework repository. They are the authoritative sources for framework behavior; the handbook summarizes and links to them. Index directly from GitHub.
Freshness signal for all framework docs: check
Last-Updatedinhttps://github.com/bemindlabs/BWOC-Framework/blob/main/VERSION.mdbefore re-fetching. Current: Software-Version2.24.0, Document-Version1.6.2, Last-Updated2026-06-06T03:44:18Z.
| URL | Language | One-line description |
|---|---|---|
README.md |
English | Framework project overview; what BWOC is, the 22 Buddhist engineering frameworks, crate map, status table, and quick-start commands. |
VISION.md |
English | Project direction, long-term goals, and the hard-tradeoff principles that govern framework design decisions. |
VISION.th.md |
Thai | Thai-language parity of VISION.md; hreflang="th". |
VERSION.md |
English | Freshness beacon: carries Software-Version (Cargo SemVer), Document-Version, Last-Updated (UTC ISO 8601), current phase, and versioning policy details. |
modules/agent-template/AGENTS.md |
English | The authoritative agent base profile spec (v2.0); single source of truth for all LLM backends; all backend files (CLAUDE.md, AGY.md, CODEX.md, KIMI.md) are symlinks to this file. |
modules/agent-template/docs/en/OVERVIEW.en.md |
English | Conceptual overview of what a BWOC agent is, its slot structure, and how the template instantiation model works. |
modules/agent-template/docs/th/OVERVIEW.th.md |
Thai | Thai-language parity of OVERVIEW.en.md; hreflang="th". |
modules/agent-template/docs/en/PHILOSOPHY.en.md |
English | The 22 Buddhist engineering frameworks that ground every structural decision in the codebase; the conceptual core of BWOC. |
modules/agent-template/docs/th/PHILOSOPHY.th.md |
Thai | Thai-language parity of PHILOSOPHY.en.md; hreflang="th". |
modules/agent-template/docs/en/PRD.en.md |
English | Product requirements document for the agent template; defines the problem space, target users, and feature requirements. |
modules/agent-template/docs/th/PRD.th.md |
Thai | Thai-language parity of PRD.en.md; hreflang="th". |
modules/agent-template/docs/en/SRS.en.md |
English | Software requirements specification structured around the Magga eightfold model; the engineering contract for agent behavior. |
modules/agent-template/docs/th/SRS.th.md |
Thai | Thai-language parity of SRS.en.md; hreflang="th". |
modules/agent-template/docs/en/SELF-IMPROVEMENT.en.md |
English | Specification of the agent self-improvement loop: how agents accumulate, evaluate, and prune knowledge across sessions. |
modules/agent-template/docs/th/SELF-IMPROVEMENT.th.md |
Thai | Thai-language parity of SELF-IMPROVEMENT.en.md; hreflang="th". |
modules/agent-template/docs/en/THREAT-MODEL.en.md |
English | Security threat model for incarnated agents: trust tiers (T0-T3), attack surface analysis, and mitigations. |
modules/agent-template/docs/th/THREAT-MODEL.th.md |
Thai | Thai-language parity of THREAT-MODEL.en.md; hreflang="th". |
Notes for operators¶
- Set the real host. Uncomment and update the
Sitemap:line inrobots.txtbefore deploying. - Site-root-relative paths in this file assume the handbook is served from the domain root. If served under a subpath (e.g.
https://example.com/handbook/), prepend that subpath to all/paths listed here. - Framework doc URLs are permanent GitHub blob links and require no operator adjustment.
- Freshness: re-check
VERSION.mdat the framework repo before deciding whether to re-index framework docs. Re-check git commit dates on individual handbook files before deciding whether to re-index handbook pages.