Skip to content

Merge LLM-friendliness remediation and transport/IPC fixes#26

Merged
hwbehrens merged 4 commits into
mainfrom
llm-friendliness-remediation
Mar 13, 2026
Merged

Merge LLM-friendliness remediation and transport/IPC fixes#26
hwbehrens merged 4 commits into
mainfrom
llm-friendliness-remediation

Conversation

@hwbehrens

Copy link
Copy Markdown
Owner

Summary

  • close out the llm-friendliness remediation plan and archive it
  • add the agent index, nested AGENTS guidance, and evaluation infrastructure
  • fix transport/IPC timeout, validation, and peer-cache issues identified in review

Verification

  • cd axon && make verify

hwbehrens and others added 4 commits February 24, 2026 22:27
…ecision log, evaluation hardening

Three-phase remediation derived from a cross-project structural comparison
with plasma-bft, refined through a Socratic exchange between two LLM agents.

Phase 1 — Foundation:
- Add document authority framework to AGENTS.md (status taxonomy, authority
  hierarchy, escalation rules, status matrix)
- Add Status: headers to all 4 spec files, CONTRIBUTING.md, and 3 rubrics
- Create docs/decision-log.md with 8 seed entries (historical decisions)
- Create docs/open-questions.md with 1 seed entry
- Add institutional-memory co-change rule to AGENTS.md invariants

Phase 2 — Routing & contextual guidance:
- Create docs/agent-index.json (machine-readable subsystem map with 10
  subsystems, 8 common tasks, validation commands)
- Create 10 nested AGENTS.md files (one per module under src/)
- Add nested-AGENTS index to root AGENTS.md
- Add agent-index co-change rule to CONTRIBUTING.md

Phase 3 — Evaluation infrastructure:
- Create rubrics/EVALUATION-PRINCIPLES.md (shared principles factored out
  of 3 existing rubrics to eliminate duplication)
- Create rubrics/README.md (concern ownership map, scoring policy,
  double-deduction guidance, spec-to-rubric traceability)
- Create rubrics/AGENT-READABILITY.md (100-point meta-rubric for LLM
  agent navigability)

Also removes spec/RETICULUM_ENHANCEMENTS.md and all references to it.

Amp-Thread-ID: https://ampcode.com/threads/T-019c9323-3f90-7518-bc0d-cdebdc732a12
Co-authored-by: Amp <amp@ampcode.com>
Static peers configured with hostnames are now re-resolved every 60
seconds. When a peer's address changes (e.g. dynamic DNS, Tailscale),
a new PeerEvent::Discovered is emitted so the daemon can reconnect.

Also:
- Suppress noisy mdns_sd crate logging (default to warn level)
- Preserve PersistedStaticPeerConfig through config resolution so
  unresolved hostnames remain available for re-resolution
- Bump version to 0.7.2

Amp-Thread-ID: https://ampcode.com/threads/T-019c9349-8163-768e-b49e-34c7bb052b31
Co-authored-by: Amp <amp@ampcode.com>
@hwbehrens hwbehrens merged commit ca86cde into main Mar 13, 2026
7 of 8 checks passed
@hwbehrens hwbehrens deleted the llm-friendliness-remediation branch March 13, 2026 21:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant