docs/llm.txt
user.email 0ca63712dc feat: add llm.txt + docs/RFC.md — agent entry points and spec index
llm.txt: standard entry point for agents landing on the repo
docs/RFC.md: categorised index of all 28 RFCs with status

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-25 10:52:46 +00:00

35 lines
1.2 KiB
Text

# core/docs — Lethean Ecosystem Documentation
> This repository contains the design specifications, RFCs, and documentation
> for the Lethean ecosystem. Start with docs/RFC.md for the full spec index.
## Entry Points
- docs/RFC.md — RFC index (start here for design specs)
- docs/specs/ — Individual RFC documents
- CLAUDE.md — Agent instructions for this repository
## Key Specifications
- RFC-025: Agent Experience (AX) — Design paradigm for AI-first codebases
- RFC-021: Core Platform Architecture — 7-layer stack, module system
- RFC-011: OSS DRM — Zero-trust digital rights management
- RFC-002: Event-Driven Modules — Module lifecycle and event system
## Ecosystem
- core/go (dappco.re/go/core) — Go DI framework, service lifecycle, IPC
- core/agent (dappco.re/go/agent) — AI agent orchestration, dispatch, verify
- core/mcp (dappco.re/go/mcp) — Model Context Protocol server
- core-php — Laravel package ecosystem (18 packages)
## Conventions
All code follows RFC-025 Agent Experience (AX) principles:
- Predictable names over short names
- Comments as usage examples
- Path is documentation
- Templates over freeform
- Declarative over imperative
- Core primitives for universal types
- Tests as behavioural specification (Good/Bad/Ugly)