Skip to content

Releases: markoblogo/AGENTS.md_generator

v0.1.4

20 Mar 12:08

Choose a tag to compare

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 snippets generates README_SNIPPETS.generated.md from AGENTSGEN:SNIPPET markers.
  • --check mode for CI: fails when generated snippets drift.
  • --dry-run, --print-diff, and --format json for 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

18 Feb 11:15

Choose a tag to compare

v0.1.3 — Pack print-plan + stability

What’s inside

  • agentsgen pack --print-plan dry 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-plan mention in LLMO Pack usage.

Safety model

No change. Safe-by-default behavior remains:

  1. Missing file -> create with marker sections.
  2. Markers present -> update only inside markers.
  3. 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 --check

Known 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.json when needed.

v0.1.2

16 Feb 09:44

Choose a tag to compare

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.txt or LLMS.md
    • docs/ai/ (how-to-run, how-to-test, architecture, data-contracts)
    • SECURITY_AI.md, CONTRIBUTING_AI.md
    • README_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 --autodetect support.

Safety model

  • Marker-only updates: if a target file contains AGENTSGEN markers, 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 --check

Known limitations

  • Monorepos are detected as mixed; pack generation is conservative (no guessing commands).
  • pack.files is 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

24 Feb 01:15

Choose a tag to compare

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