Releases: markoblogo/AGENTS.md_generator
Releases · markoblogo/AGENTS.md_generator
v0.1.4
v0.1.4 — README Snippets (mini-validator)
This release adds a safe way to extract “canonical” agent-facing snippets from README.md without editing README itself.
What’s inside
agentsgen snippetsgeneratesREADME_SNIPPETS.generated.mdfromAGENTSGEN:SNIPPETmarkers.--checkmode for CI: fails when generated snippets drift.--dry-run,--print-diff, and--format jsonfor reviewable workflows.
Safety model
- README is never modified.
- Generated output is deterministic and reviewable.
Quickstart
- Add markers to README.md: …
- Run:
agentsgen snippets . - CI check:
agentsgen snippets . --check
Known limitations
- Only README.md is supported in v0.1.x (no multi-file snippet sources yet).
- No nested snippets; snippet names must be unique.
v0.1.3
v0.1.3 — Pack print-plan + stability
What’s inside
agentsgen pack --print-plandry preview (no writes) with--format text|json.- Print-plan JSON now includes
version; text output now includes a short header (repo,autodetect,output_dir,files_count). - Pack print-plan tests hardened against Rich line wrapping on long paths.
- README already includes positioning lines and
--print-planmention in LLMO Pack usage.
Safety model
No change. Safe-by-default behavior remains:
- Missing file -> create with marker sections.
- Markers present -> update only inside markers.
- No markers -> write
*.generated.*siblings instead of overwriting handwritten docs.
Quickstart
pipx install git+https://github.com/markoblogo/AGENTS.md_generator.git
agentsgen init . --defaults --autodetect
agentsgen pack . --autodetect --print-plan --format text
agentsgen pack . --autodetect --checkKnown limitations
- Print-plan text output may wrap in narrow terminals (Rich layout), but CLI tests now account for wrapping.
- Auto-detect remains conservative by design; set explicit commands in
.agentsgen.jsonwhen needed.
v0.1.2
v0.1.2 — LLMO Pack (AI indexing bundle) + CI drift check
This release adds a new LLMO Pack generator to agentsgen and makes it CI-friendly.
What’s inside
agentsgen pack- generates an AI/LLMO indexing documentation bundle:llms.txtorLLMS.mddocs/ai/(how-to-run,how-to-test,architecture,data-contracts)SECURITY_AI.md,CONTRIBUTING_AI.mdREADME_SNIPPETS.md
agentsgen pack --check- detects drift without writing files (exit code 1 on drift).agentsgen pack --format json- machine-readable output for tooling/CI.- Stack presets:
python,node,static, with--autodetectsupport.
Safety model
- Marker-only updates: if a target file contains
AGENTSGENmarkers, only marker ranges are replaced. - No markers = no overwrite: writes
*.generated.*siblings instead of touching the original. - Path safety: pack outputs are restricted to the target directory (no path traversal).
Quickstart
pipx install git+https://github.com/markoblogo/AGENTS.md_generator
agentsgen pack --autodetect
agentsgen pack --autodetect --checkKnown limitations
- Monorepos are detected as
mixed; pack generation is conservative (no guessing commands). pack.filesis an output allowlist (see docs for matching behavior).- Templates are intentionally minimal - treat pack as a strong starting point, not final docs.
Docs: docs/llmo-pack.md
v0.1.1
Release Notes - v0.1.1
What's New
- Initial release
Features
- Add key features here
Bug Fixes
- List bug fixes here
Improvements
- List improvements and enhancements here
Breaking Changes
- List any breaking changes here (if applicable)
Known Issues
- List any known issues here (if applicable)
Full Changelog: https://github.com/OWNER/REPO/commits/v0.1.1