Coding guidelines generator

Goal

Create nested AGENTS.md files (not repo root) that define:

• •architecture preferences + boundaries (high level)
• •formatting/lint/testing commands (runnable)
• •a small verifiable config block the verifier skill can execute

Minimal questions to ask (don’t skip)

• •Where are the module roots? (Confirm the folders that should each get an AGENTS.md; avoid repo root unless explicitly requested.)
• •Architecture style: layered / hex / clean (pick one) and any hard boundaries (e.g., domain/ must not import infra/).
• •OK to add tooling when missing? (default: yes; Spotless for Java/Kotlin)
• •Default commands: format / lint / test for each module (changed-files-first where practical).

Workflow (monorepo-aware)

1. •Scan for candidate modules and languages.
   • •Use scripts/scan_modules.py to produce a quick inventory.
   • •If python is not available or the script fails, tell the user and ask whether to install Python or proceed with a manual module scan.
2. •Propose the nested AGENTS.md placement(s) and get confirmation.
   • •If the only detected module is repo root, suggest a subdir (e.g., src/, apps/<name>/, packages/<name>/) or ask the user where the code “starts”.
3. •For each confirmed module root:
   • •Create/update <module>/AGENTS.md using references/agents-template.md.
   • •Fill the codex-guidelines JSON block (schema: references/verifiable-block.md) with runnable commands.
4. •Ensure formatting + linting exist (prefer existing; otherwise add best-practice defaults).
   • •JVM (Gradle/Maven): add/configure Spotless (see references/spotless.md).
   • •Others: pick a minimal, common default and wire commands into AGENTS.md (see references/language-defaults.md).

Deliverable

Provide:

• •The list of module roots covered and each AGENTS.md created/updated.
• •The codex-guidelines command block per module (format/lint/test).
• •Any tooling/config changes added (e.g., Spotless) and where they live.