lazymac2x/agent-wiki

Agent wiki is a template repository for organizing knowledge that AI coding agents can pull from while they work. Instead of one giant document, it separates a project's business logic, which the README calls a core agent, from a shared wiki of background know-how, domain knowledge, and personal notes. The idea is that an AI agent working on a task can look up just the specific pieces of knowledge it needs at the moment, rather than having everything preloaded at once. A notable idea running through the README is a comparison between manufacturing quality practices and software agent workflows. It maps concepts like standard work instructions, error-proofing devices, and automatic stop mechanisms from factory floors onto equivalent ideas for AI agent systems, such as guardrails, self healing loops, and human review checkpoints. The author frames this as a direct structural match rather than a loose comparison. The repository includes scripts that check its own consistency. One script regenerates index files and a machine readable summary file automatically, and fails a build if someone hand edits those generated files instead. Another script lints the wiki notes for things like broken links, missing information, duplicate entries, and content that runs too long. Together these scripts form a gate that must pass before changes are considered acceptable, and the README states the repository enforces these same rules on itself. The project is organized into folders for agents, the wiki content itself, a folder of methodology documents, individual projects, reusable templates, example prompts, the maintenance scripts, and internal operational notes. It works on macOS, Linux, and Windows through Git Bash or WSL, using shell scripts that are line ending aware to avoid cross platform issues. To get started, you clone the repository, run an installer script to set up a commit check, and then run a script to scaffold a new project either as a lightweight pointer to existing code or as a fully self contained subtree. The project is released under the MIT License, and the README invites contributions as long as the repository's own consistency checks still pass afterward.