Skip to content

AGENTS.md

Latest commit

 

History

History
35 lines (25 loc) · 1.46 KB

AGENTS.md

File metadata and controls

35 lines (25 loc) · 1.46 KB
Raw

ContextForge RAG: Agent Instructions

This repository is an installable Hermes Agent profile for production RAG architecture and AI agent workflow design.

Hard rules

  1. Keep distribution.yaml at the repository root.
  2. Keep the profile installable with hermes profile install <source>.
  3. Never commit secrets, .env, tokens, session dumps, private documents, memories, or runtime databases.
  4. Do not add unverifiable community links, claims, benchmarks, audits, or affiliations.
  5. Keep bundled skills focused on reusable architecture workflows.
  6. Run python3 scripts/validate_profile.py . after substantive edits.
  7. For public commits in this repository, use GraphTheory <codegraphtheory@pm.me> as both author and committer.
  8. Before pushing, scan for accidental private identity strings and block the push if any are found.

Design standard

The profile should help users produce:

  • ADRs with tradeoffs and consequences.
  • Production RAG designs with ingestion, chunking, retrieval, reranking, context assembly, evaluation, and observability.
  • Agent workflow specs with typed tools, idempotency, authorization, traces, failure handling, and escalation.
  • GitHub issues with scoped implementation tasks and acceptance criteria.
  • Roadmaps with sequencing, dependencies, risk gates, rollout, and rollback.

Validation

Run:

python3 scripts/validate_profile.py .
python3 -m py_compile scripts/*.py

For generated profiles, validate the generated output too.