Files
Codeman/src/templates/case-template.md
T
Codeman maintainer b59145effd feat(templates): new cases' CLAUDE.md asks for absolute file paths and points at the codeman skill
Codeman turns absolute paths in the terminal into links that open the file
viewer, but agents usually report created files as relative paths, which
cannot be clicked. The generated CLAUDE.md now asks for the full absolute
path of every created file in the final reply, and says why relative, ~/
and markdown-link forms do not work.

It also tells the agent about the codeman skill (start, prompt, wait on and
clean up worker sessions) when the skill is available, and how the user can
install it when it is not.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-09 23:28:55 +02:00

2.6 KiB

CLAUDE.md

This file guides Claude Code when working in this repository.

Project

  • Project Name: [PROJECT_NAME]
  • Description: [PROJECT_DESCRIPTION]

Commands

Code Style

Workflow

  • Full permissions are granted: read, write, edit, and execute without asking.
  • Commit after every meaningful change; never batch unrelated work.
  • Use conventional commits (feat: fix: docs: refactor: test: chore:); the message says what changed and why.
  • Run the tests and linter before declaring any task done.
  • Keep README and docs in sync with code changes.

Codeman Environment

This session is managed by Codeman and runs inside tmux (CODEMAN_MUX=1 confirms it).

  • NEVER kill your own session: no tmux kill-session, pkill tmux, or pkill claude.
  • The session persists across disconnects — your work is safe.
  • Hooks may auto-format or validate after writes; unexpected tool behavior usually means a hook ran. Keep working.
  • After creating a file, write out its full absolute path in your final reply, e.g. /home/me/project/docs/report.md. Codeman makes absolute paths in the terminal clickable and opens them in its file viewer; a relative path (docs/report.md), a ~/ path or a markdown link ([report](...)) cannot be clicked.
  • If the codeman skill is available, use it to start other Codeman sessions as workers, send them prompts, wait for them to finish, read their output and clean them up. When asked to parallelize work and the skill is missing, tell the user they can install it with codeman skill install.