mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-14 03:09:44 +02:00
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>
2.6 KiB
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, orpkill 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
codemanskill 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 withcodeman skill install.