AGENTS.md@docs/development git:20260705.989b662A

Immutable. This exact content is served forever at /api/v1/blob/1dbc4936afd1a038.

# Development Documentation

## Overview

Technical guide for `docs/development/` — contribution guidelines, testing, security, and development roadmap.

## Files

| File | Purpose |
|------|---------|
| `contributing.md` | Contribution guidelines and process |
| `code-of-conduct.md` | Community standards |
| `security.md` | Security policy and vulnerability reporting |
| `roadmap.md` | Development roadmap and future plans |
| `coverage-gaps.md` | Test coverage gap analysis |
| `testing/testing-guide.md` | Testing framework and patterns |
| `testing/testing-with-credentials.md` | External service credential testing |
| `no-mocks-http-testing.md` | No-mocks HTTP testing with `pytest-httpserver` |
| `code-review-checklist.md` | Eight-criterion review checklist |
| `validation_gates.md` | Validation gate stages and enforcement |
| `contribution-map.md` | Pre-contribution overlap check, contribution-shape routing, current live repo signals |
| `optional-dependencies.md` | Capability matrix for optional dependency groups and their gating behavior |

## Key Conventions

- **Project layout reference**: [`projects/templates/template_code_project/`](../../projects/templates/template_code_project/); discoverable names → [_generated/active_projects.md](../_generated/active_projects.md).
- All contributions require tests (90% project, 60% infrastructure coverage)
- No mocks — all tests use real numerical examples
- Thin orchestrator pattern enforced for all scripts
- Security vulnerabilities reported via `security.md` process

## See Also

- [README.md](README.md) — Quick navigation
- [Contributing](contributing.md) — How to contribute
- [Testing](testing/) — Testing sub-folder