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>
This commit is contained in:
Codeman maintainer
2026-10-09 23:28:55 +02:00
parent 3a0cee6b90
commit b59145effd
2 changed files with 16 additions and 0 deletions
+2
View File
@@ -56,3 +56,5 @@ This session is managed by Codeman and runs inside tmux (`CODEMAN_MUX=1` confirm
- 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`.
+14
View File
@@ -61,6 +61,20 @@ describe('generateClaudeMd', () => {
expect(result).toContain('CODEMAN_MUX=1');
});
it('should tell the agent to print absolute paths of files it creates', () => {
const result = generateClaudeMd('my-project');
expect(result).toContain('full absolute path');
expect(result).toContain('clickable');
});
it('should point the agent at the codeman skill', () => {
const result = generateClaudeMd('my-project');
expect(result).toContain('`codeman` skill');
expect(result).toContain('codeman skill install');
});
it('should include workflow rules', () => {
const result = generateClaudeMd('my-project');