chriswiles/claude-code-showcase

This repository is a working example of how to configure Claude Code, an AI coding assistant, so it operates as a well-trained teammate on a specific software project rather than a generic tool. The author shares their own project setup so other developers can copy and adapt it. The core idea is that Claude Code can read special files you place in a project folder before it does any work. Those files teach it your team's conventions: how you write tests, how you structure your database queries, what code style you follow, and what your custom component library looks like. Once those files are in place, code the assistant generates already matches your patterns without you having to explain them each time. The repository demonstrates several layers of this setup. Skills are plain-text documents that explain specific topics to Claude, like how to use a particular internal library or how to name files. Agents are specialized assistants for recurring tasks, such as a code review agent that goes through a detailed checklist every time changes are made. Commands are shortcuts you can invoke by typing a slash followed by a name, for example triggering a full pull request review workflow in a single step. Hooks are another piece shown here. These are small scripts that run automatically at certain moments, such as blocking edits on the main protected branch, running the formatter whenever a file is saved, or suggesting relevant skills when Claude reads a particular prompt. The repository also includes GitHub Actions workflows that run Claude on a schedule. A monthly workflow reads recent commits and checks whether the documentation still describes the code accurately. A weekly one reviews code quality in rotating directories. A biweekly one audits and updates dependencies. The repo is structured so a developer can copy the folder layout into their own project and fill in the content with their own conventions. Most files are Markdown documents, making them easy to read and edit without any special tooling.