Agent Directives — High-Leverage Brevity Sheet

A single-file, offline-safe HTML reference sheet for LLM project agents, coding assistants, repo audits, skill design, security-sensitive workflows, prompt packs, and engineering control directives.

Live site:

https://theislampill.github.io/adhlbs/

What this is

This project publishes an interactive HTML sheet of compact, high-leverage directives for agentic work.

It includes:

• Default dispatch stacks for common agent workflows
• Directive cards for software engineering, web foundations, security, reliability, testing, skill engineering, and agent control
• Defense-in-depth guidance for LLM/tool systems
• Claude/Hermes/Codex-oriented skill notes
• Ready-to-paste prompt packs
• Static source table with inert, copyable source URLs

The artifact is designed to be useful for:

• CLAUDE.md
• Hermes skills
• Codex task prompts
• repo-agent instructions
• audit checklists
• security-sensitive tool workflows
• print/PDF reference

Current published file

docs/index.html

GitHub Pages should be configured to publish from:

Branch: main
Folder: /docs

Design constraints

The HTML artifact is intentionally offline-safe:

• no remote fonts
• no external stylesheets
• no external scripts
• no external images
• no iframes
• no fetch/XHR/WebSocket/EventSource/sendBeacon/import/service-worker use
• source URLs are inert copyable text, not auto-loading resources

Operational principles

The sheet is built around compact, recognizable directives such as:

RTFM
TRACE
SSOT
DRY
KISS
YAGNI
SOLID
GRASP
ACID
Poka-yoke
Genchi Genbutsu
WCAG / POUR
TDD / BDD / E2E
STRIDE
ZTA
RAG
MCP
ReAct

The controlling idea:

GENCHI GENBUTSU / RTFM → TRACE → SSOT → DRY → SOLID/GRASP → KISS/YAGNI/LoP → ACID WRITE → POKA-YOKE → VERIFY

Repository layout

atomics/
  *.json       # canonical directive, stack, pack, source, and UI records

tools/
  build_docs_index.py              # generates docs/index.html
  check_adhlbs_atomics.py          # validates atomics and generated coverage
  check_docs_index_freshness.py    # fails when docs/index.html is stale
  check_docs_index_offline.py      # scans for active remote/network behavior

docs/
  index.html   # generated GitHub Pages artifact

README.md      # repository overview

Update workflow

docs/index.html is generated. Treat atomics/** as the source of truth. Do not hand-edit docs/index.html except for emergency recovery.

After editing atomics, run:

python tools/build_docs_index.py
python tools/check_adhlbs_atomics.py
python tools/check_docs_index_freshness.py
python tools/check_docs_index_offline.py

The artifact remains a single-file, static, offline-safe HTML page. GitHub Pages should still publish from main / docs.

License

No license has been selected yet. Until a license is added, default copyright applies.