{
"type": "docs",
"version": "1.0",
"entries": [
{
"title": "Information Flow Tracking",
"summary": "Track data origin and sensitivity through agent systems using taint labels to prevent information leakage and enforce security policies",
"path": "information-flow/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing security controls for agent systems handling mixed-sensitivity data",
"Implementing data flow tracking and taint analysis",
"Preventing information leakage in multi-agent systems",
"Understanding information flow security patterns"
]
},
{
"title": "Taint Audit Log Events",
"summary": "Event schema for taint tracking audit logs - structured records of taint operations for compliance and analysis",
"path": "information-flow/audit-events.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Implementing taint supervisor audit logging",
"Building audit log analysis tools",
"Designing compliance and monitoring systems",
"Understanding taint tracking observability"
]
},
{
"title": "Taint Specification Language (TSL) Core",
"summary": "Declarative YAML format for specifying taint policies - sources, sinks, and basic propagation rules",
"path": "information-flow/tsl-core.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Defining taint policies declaratively for agent systems",
"Creating portable taint specifications across implementations",
"Implementing policy-as-code for information flow tracking"
]
},
{
"title": "Taint Supervisor Pattern",
"summary": "Centralized architecture for managing taint assignment, policy enforcement, and audit logging in information flow tracking systems",
"path": "information-flow/taint-supervisor.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing centralized taint management for agent systems",
"Implementing audit trails for information flow tracking",
"Refactoring scattered taint assignment into a unified system",
"Building policy management for data flow controls"
]
},
{
"title": "What are Tools?",
"summary": "Tools are executable capabilities that agents can invoke to interact with systems, APIs, and external resources beyond text generation.",
"path": "tools/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Understanding what tools are and how they work",
"Designing tool systems for agents",
"Implementing tool execution and security",
"Establishing tool specifications and contracts"
]
},
{
"title": "Tool Execution Policy",
"summary": "Autonomous agents execute tools with user authority. Security through transparency, logging, and user consent.",
"path": "tools/execution-policy.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing agent tool execution systems",
"Understanding agent security model",
"Implementing tool invocation and logging"
]
},
{
"title": "Model Context Protocol (MCP)",
"summary": "Anthropic's standard protocol for connecting AI models to tools, resources, and data sources through a client-server architecture.",
"path": "tools/mcp-protocol.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Implementing tool servers for agents",
"Integrating external tools and resources",
"Understanding MCP architecture and capabilities",
"Building MCP-compatible systems"
]
},
{
"title": "Bootstrap",
"summary": "Bootstrap guides for minimal setup of the agent development workspace with core repositories and tooling.",
"path": "bootstrap/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Setting up the agent workspace for the first time",
"Bootstrapping the agent development environment quickly",
"Getting minimal working setup with core repositories",
"Initial workspace configuration and IDE integration"
]
},
{
"title": "Agent Workspace Setup",
"summary": "Minimal setup guide for bootstrapping agent workspace with core repositories, rule templates, and IDE integration.",
"path": "bootstrap/development-environment.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2026-07-15",
"status": "active",
"read_when": [
"Setting up the agent workspace for the first time",
"Bootstrapping with core repositories and rule templates",
"Getting minimal working setup with Amazon Q integration",
"Initial workspace configuration from scratch"
]
},
{
"title": "Agent Definition",
"summary": "Foundational definition of agents - autonomous software entities with identity, capabilities, and security boundaries that operate within agent systems",
"path": "agents/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Understanding the fundamental concept of agents in agent systems",
"Designing agent architectures and interaction patterns",
"Planning agent security and capability models",
"Establishing agent system terminology and concepts"
]
},
{
"title": "Agent Manifest Specification",
"summary": "Authoritative specification for agent manifests - the declarative format for agent identity, capabilities, runtime configuration, and security policies",
"path": "agents/agent-manifest-specification.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing agent systems that require capability-based security",
"Planning agent identity and authorization mechanisms",
"Architecting agent registries and management systems",
"Creating agent manifest authoring and validation tools"
]
},
{
"title": "Agent Manifest Registry Specification",
"summary": "Registry system for storing, versioning, and managing signed agent manifests with support for hot reload, revocation, and lifecycle operations",
"path": "agents/agent-manifest-registry.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing agent manifest storage and versioning systems",
"Building agent registry services and management APIs",
"Planning manifest distribution and synchronization mechanisms",
"Creating manifest lifecycle management tools"
]
},
{
"title": "What are Documents?",
"summary": "Documents are markdown files with machine-readable frontmatter that provide knowledge to agents on demand.",
"path": "docs/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Understanding what documents are and how they work",
"Learning about the document format and structure",
"Implementing document support in an agent system"
]
},
{
"title": "Documentation Hub",
"summary": "Multi-source documentation registry hub with Git repositories, CI pipelines, and index.json for on-demand knowledge loading.",
"path": "docs/hub.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing the doc hub system or index.json contract",
"Evaluating whether a doc hub is useful for a specific domain or team",
"Comparing doc hub design to skill hub design"
]
},
{
"title": "Hub Configuration",
"summary": "Unified configuration format for managing both skill and documentation hub sources in agent systems",
"path": "docs/hub-configuration.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Implementing hub source management in agent systems",
"Designing agent configuration files",
"Understanding hub discovery and caching mechanisms",
"Configuring multiple skill and doc hubs"
]
},
{
"title": "Specification Organization",
"summary": "Organizational principles for agent foundation specifications including domain grouping, naming conventions, and cross-reference standards.",
"path": "docs/organization.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Deciding where to place a new specification document",
"Establishing naming conventions for specification files",
"Setting up cross-reference standards between specifications"
]
},
{
"title": "Documentation Authoring",
"summary": "How to author documentation files with machine-readable YAML frontmatter for Agent Zero.",
"path": "docs/authoring-guide.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Writing or reviewing a documentation file",
"Adding frontmatter to an existing doc",
"Designing the doc discovery or context-loading system",
"Understanding cross-reference fields between artifact types"
]
},
{
"title": "Rules",
"summary": "Best practices for creating and managing workspace rules for AI behavior enforcement.",
"path": "rules/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Creating new workspace rules for AI behavior",
"Designing rule architecture and organization",
"Maintaining existing rule sets",
"Understanding rule vs prompt differences"
]
},
{
"title": "Rule Creation Best Practices",
"summary": "Software engineering principles and patterns for creating maintainable workspace rules.",
"path": "rules/best-practices.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Creating new workspace rules",
"Refactoring existing rule architecture",
"Designing rule systems for AI behavior enforcement",
"Applying software engineering principles to rule design"
]
},
{
"title": "Workspace Rule Implementation",
"summary": "Implementation patterns for workspace-level AI behavior rules, portable across Amazon Q, Cursor, Copilot, and other AI systems.",
"path": "rules/workspace-implementation.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2026-07-15",
"status": "active",
"read_when": [
"Implementing workspace rules in new projects",
"Setting up AI behavior enforcement systems",
"Adapting rule patterns to different workspaces or AI systems",
"Understanding rule implementation architecture"
]
},
{
"title": "What are Skills?",
"summary": "Skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge and workflows.",
"path": "skills/definition.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-07-14",
"status": "active",
"read_when": [
"Understanding what skills are and how they work",
"Learning about the SKILL.md format and structure",
"Implementing skills support in an agent system"
]
},
{
"title": "Skill Lifecycle Specification",
"summary": "Foundational specification for skill installation, versioning, updates, and removal in agent systems",
"path": "skills/lifecycle.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing skill management systems",
"Understanding skill lifecycle states and transitions",
"Implementing skill registries or package managers",
"Establishing skill versioning and conflict resolution policies"
]
},
{
"title": "Lifecycle YAML Format",
"summary": "Complete specification for lifecycle.yaml format - agent-assisted skill dependency management with install, update, and uninstall commands",
"path": "skills/lifecycle-format.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Writing lifecycle.yaml for a skill",
"Implementing lifecycle command execution in an agent",
"Understanding skill dependency management"
]
},
{
"title": "Skill Hub",
"summary": "Multi-source skill registry hub with Git repositories, CI pipelines, and index.json for skill distribution and management.",
"path": "skills/hub.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-01-16",
"status": "active",
"read_when": [
"Designing the hub system, the index.json contract, CI pipeline for a hub repo",
"Setting up multi-hub configuration model",
"Comparing skill hub design to doc hub design"
]
},
{
"title": "Skill Authoring",
"summary": "How to author SKILL.md files with machine-readable YAML frontmatter.",
"path": "skills/authoring-guide.md",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"last_updated": "2025-07-14",
"status": "active",
"read_when": [
"Writing or reviewing a SKILL.md file",
"Implementing load-time gating or keyword scoring",
"Designing the requires block or description field"
]
}
],
"metadata": {
"generated_at": "2026-03-08T22:29:41.697590+00:00",
"commit_hash": "a822f52f3264c41c557e26be99d0def718e4f4a8",
"total_entries": 25
}
}