🇬🇧 English | 🇮🇹 Italiano

PLW-template

A GitHub template for starting software projects built with the support of AI agents.

Note: this README is in English, but the rest of the repository (AGENTS.md, LLMWiki/, Loop/) is written in Italian, the maintainer's working language. AI agents work with it regardless of the language you write to them in.

This repository is, at the same time:

• an Obsidian vault, openable directly from the root;
• a working environment for AI agents (persistent memory + task system);
• a reusable template for new projects.

Structure

/
├── AGENTS.md      # shared instructions for AI agents (main source)
├── CLAUDE.md       # bridge: tells Claude Code to read AGENTS.md
├── LICENSE         # MIT license
├── .github/        # issue and pull request templates
├── .obsidian/       # minimal Obsidian vault configuration
├── LLMWiki/         # persistent project memory — see LLMWiki/README.md
├── Loop/            # working loop for agents — see Loop/README.md
└── Project/         # the actual project — empty in the template

For the detailed operational rules for agents, see AGENTS.md (Italian).

Compatibility across agentic tools

AGENTS.md is the single source of truth and is meant to be read directly by any tool that follows this convention (e.g. Codex CLI). CLAUDE.md exists only because Claude Code looks for a file with that name by default: it's just a bridge to AGENTS.md. No shared file contains commands or syntax specific to a single tool.

How to start a new project from this template

1. On GitHub, use the "Use this template" button on this repository, or from the command line: gh repo create <name> --template TobiaRigon/PLW-template --public (use --private for a private copy; add --clone to clone it locally right away).
2. Clone the new repository locally.
3. Open the root folder as a vault in Obsidian.
4. Replace/update Project/README.md with the description of the real project and start writing code inside Project/.
5. Populate LLMWiki/: add sources under LLMWiki/raw/, let the agent derive pages under LLMWiki/wiki/, updating index.md and log.md.
6. Write the first task in Loop/TASK.md and configure Loop/check.sh with the project's real checks (build, lint, test...).

Template status

The template structure is defined: Loop/ (task cycle) and LLMWiki/ (persistent memory) — see AGENTS.md. What remains project-specific is the content of Loop/check.sh and the wiki's own content.

License

MIT.