# Structured Context

> Scoped, structured context for AI agents. Drop AGENTS.yaml files into your codebase and agents get the right guidance at the right time.

sctx replaces monolithic instruction files with distributed AGENTS.yaml files placed throughout a codebase. When an AI agent edits a file, sctx discovers nearby AGENTS.yaml files, filters their instructions by glob patterns and action type, and delivers only the relevant context just-in-time. This ensures agents receive precise, scoped guidance instead of an overwhelming wall of instructions.


## Getting Started

- [Getting started](https://sctx.dev/getting-started/index.md): Installation via Homebrew, go install, or binary download; Claude Code integration setup

## Core Concepts

- [Context entries](https://sctx.dev/context/index.md): How to write context entries with match, exclude, on, and when filters
- [Decisions](https://sctx.dev/decisions/index.md): Recording rejected alternatives, constraints, and revisit conditions

## Documentation

- [Examples](https://sctx.dev/examples/index.md): Complete AGENTS.yaml files for dbt, APIs, React, Terraform, and monorepos
- [Protocol](https://sctx.dev/protocol/index.md): File discovery, resolution algorithm, merge behavior, and validation rules for implementors
- [CLI reference](https://sctx.dev/cli-reference/index.md): CLI commands including hook, context, decisions, validate, init, claude enable/disable
- [Comparisons](https://sctx.dev/comparisons/index.md): How sctx differs from AGENTS.md, MCP, llms.txt, and .cursorrules

## Optional

- [Contributing](https://sctx.dev/contributing/index.md): Building, testing, and contributing
- [Roadmap](https://sctx.dev/roadmap/index.md): Planned features for v2 and v3