Reda Tarzalt
a5ebaf5dd7
Some checks failed
Run Check Script / check (pull_request) Failing after 44s
32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# Harmony Codebase Resources
|
|
|
|
## Knowledge
|
|
|
|
- [Repository contract: `AGENTS.md`](./AGENTS.md)
|
|
Canonical contribution rules: minimalism, Score-Topology-Interpret, capability boundaries, deploy architecture, build commands.
|
|
- [Guide: Writing a Score](./docs/guides/writing-a-score.md)
|
|
Practical introduction to declaring desired state, capability trait bounds, and Interpret execution logic.
|
|
- [Guide: Writing a Topology](./docs/guides/writing-a-topology.md)
|
|
Use when learning how environments expose capabilities to Scores.
|
|
- [Guide: Adding Capabilities](./docs/guides/adding-capabilities.md)
|
|
Use when a change needs a new domain-level infrastructure capability.
|
|
- [ADR-002: Hexagonal Architecture](./docs/adr/002-hexagonal-architecture.md)
|
|
Explains the domain versus infrastructure adapter split.
|
|
- [ADR-003: Infrastructure Abstractions](./docs/adr/003-infrastructure-abstractions.md)
|
|
Use for capability naming and vendor-boundary decisions.
|
|
- [ADR-015: Higher-Order Topologies](./docs/adr/015-higher-order-topologies.md)
|
|
Use for topology composition and blanket capability forwarding.
|
|
- [ADR-023: Deploy Architecture](./docs/adr/023-deploy-architecture.md)
|
|
Canonical deploy rules: Scores over manifests, deploy crates, smoke-test ownership, topology selection.
|
|
- [Workspace manifest: `Cargo.toml`](./Cargo.toml)
|
|
Map of crates and their rough system boundaries.
|
|
|
|
## Wisdom (Communities)
|
|
|
|
- Project maintainers and code review in this repository.
|
|
Best source for contribution judgment because many rules are project-specific and enforced by review taste.
|
|
|
|
## Gaps
|
|
|
|
- No external community is recorded yet; this mission is repository-specific, so maintainers are the primary wisdom source.
|