ganimjeong/harness-for-claude

This repository is a small starter template that someone can copy when they begin a new project they expect to work on with an AI coding agent, especially Claude Code. The idea is that every new project gets the same predictable shape: one place where the agent reads its instructions, one command to install dependencies, one command to run checks, and one command to run tests. That way the agent does not have to guess where things live, and the human collaborator can rely on the same routine across projects. The agent guide is kept in a file called AGENTS.md, which is the cross-tool format that Codex, Cursor, Aider, and similar tools also read. A second file named CLAUDE.md is a symlink that points at AGENTS.md, so Claude Code picks up the same content without any duplication. The README warns Windows users that the symlink will only work if developer mode is on and a specific git setting is enabled, otherwise CLAUDE.md will appear as a plain file with the text 'AGENTS.md' inside it. Three shell scripts sit in a 'scripts' folder. The bootstrap script tries to install or prepare dependencies when it can spot a known stack. The check script runs formatting, linting, type checks, and tests when those tools are present. The test script runs only the test suite. These are written as safe defaults for a new or near-empty repo, and the author expects each team to extend them as the project grows. The template also ships a .claude folder for Claude-specific configuration. It contains a checked-in settings.json for permissions and hooks, an example local-only settings file for personal tweaks, a commands folder for project-scoped slash commands, a hooks folder with two default hooks, and an empty agents folder for project sub-agents. The two default hooks add useful context at the start of a session, including the current branch and any uncommitted work, and run the check script before the session ends, blocking the end if those checks fail. A pull request template in the .github folder lines up PR descriptions with the same checklist the agent follows.