Show HN: Agent Dev Guide – Generate structured context docs for AI coding agents

1 pllu 0 8/15/2025, 2:37:26 PM github.com ↗
Hi HN! I've been working on a tool to auto-generate a comprehensive developer guide for AI agents working with your codebase.

It analyses your codebase against structured architecture patterns and development capabilities, producing a markdown document that maps out:

- Your architecture (code layout, application layers, frameworks, standards) - Development capabilities (how to interact with servers, read logs, run scripts, access test data, debug) - Guidance for continuous improvement as your app evolves

It takes minutes to try: run the generator prompt in your workspace using Claude Code, Cursor, or any AI coding tool (works best with extended thinking models). You can use the output in rules files like CLAUDE.md or .cursor/rules.

The tool is technology-agnostic, so should work for a wide range of apps, tools, services and libraries. There's a plugin system that gives the generator hints about technology-specific documentation (SST v3 plugin included as an example).

GitHub: https://github.com/martinpllu/agent-dev-guide Example output: https://github.com/martinpllu/agent-dev-example/blob/main/ag...

I'd love feedback from anyone trying this out.

Comments (0)

No comments yet