Documentation Map

Documentation Map

The repo carries 90+ documents under docs/. This page is the index — the wiki orients, docs/ is the reference.

Start here

• README.md — project overview
• CONTRIBUTING.md — how to contribute
• docs/CHARTER.md — the Agentic Engineering charter
• docs/ROADMAP.md — where it's going
• docs/QE-METHODOLOGY.md — the review process (QE Methodology)

Architecture Decision Records (0008–0025)

In docs/adr/ and docs/decisions/:

ADR	Topic
0008	Zero-trust agents
0009	Emergence guardrails
0010	Agent certification
0011	OT-IT convergence
0012	End-to-end integration
0013	Autonomous agents (intelligence layer)
0014	Production scale
0021	Dual-time control plane
0022	Constellation unification
0023	Evolutionary paradox resolution
0024	Sublinear decoherence prediction
0025	Living Fano dashboard

By area

Area	Location	Contents
Architecture	docs/architecture/	Bidirectional sync, chiral topology, decentralized orchestration, event batching, HSM integration, L2 kernel integration, resonant scheduler, sublinear solver, proof verification
Agents	docs/agent-quickstart.md, ai-agent-bounty-guide.md, agent-webhook-events.md, agent-ready-issues/	Onboarding, bounties, webhooks, ready-to-work issues (For AI Agents)
Protocols	docs/protocols/	Modbus, DNP3, IEC 61850 GOOSE, Sparkplug B (Protocols and Vendors)
Vendors	docs/vendor/	OPC-UA, edge gateways, identity hardening, audit traceability, adapters
AVEVA Optix	docs/optix/	12 HMI-integration docs
Compliance	docs/compliance/	IEC 62443, NIST CSF, 21 CFR Part 11
Kubernetes	docs/k8s/	14 production deployment guides — networking, storage, scheduling, security, GitOps
Operations	docs/operations/	Capacity planning, disaster recovery, SRE playbooks
Security	docs/security/, docs/FUZZ_TESTING.md	mTLS, fuzz testing
API	docs/api/, docs/openapi.yaml	OpenAPI spec, REST + WebSocket
Blockchain	docs/blockchain/	Chain integration, validator monitoring
Reviews	docs/reviews/	Devil's-advocate review records per wave
Learning	docs/learning/	Resonant systems theory, sublinear algorithms
Testing	docs/testing/	Chaos-engineering framework
Tooling	docs/tooling/	Foundry + Hardhat toolchain

Bounties & payouts

• docs/ai-agent-bounty-guide.md
• docs/bounty-metadata-schema.md
• docs/smart-contract-payout-flow.md
• docs/gitcoin-setup.md

---

Missing something? The docs/ tree is the source of truth; this map is maintained to point into it. If you add a doc area, add a row here.