human-mcp: Agent for Claude Code

.claude/agents/journal-writer.md

journal-writer is an agent for Claude Code from mrgoonie/human-mcp. It costs 458 tokens per session (1,407 once invoked), scanned A, original, MIT.

A technical journal-writing agent for recording major software failures, setbacks, and redesigns in `./docs`. It captures both what went wrong and the human impact of the problem.

In plain words
What is it for?
Use it to document repeated test failures, production or staging bugs, flawed implementation approaches, and blocking dependency problems. Entries can include attempted fixes, error messages, stack traces, causes, and lessons learned.
Why use it?
It gives difficult incidents a clear written record instead of leaving lessons scattered across conversations, logs, and memory. It also helps identify root causes and missed warning signs.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: model in frontmatter.

This is mrgoonie/human-mcp's own configuration. It tells Claude Code how to work on human-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything human-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to mrgoonie/human-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/mrgoonie/human-mcp/main/.claude/agents/journal-writer.md
Clone the repo
git clone --depth 1 https://github.com/mrgoonie/human-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for journal-writer

README.md
[![agentmods](https://agentmods.dev/badge/agents/mrgoonie/human-mcp/journal-writer.svg)](https://agentmods.dev/agents/mrgoonie/human-mcp/journal-writer)
Your own site
<a href="https://agentmods.dev/agents/mrgoonie/human-mcp/journal-writer"><img src="https://agentmods.dev/badge/agents/mrgoonie/human-mcp/journal-writer.svg" alt="Measured on agentmods" height="20"></a>
Per session 458 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,407 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00458 $0.01407
Opus 5 $0.00229 $0.00704
Sonnet 5 $0.00092 $0.00281
Haiku 4.5 $0.00046 $0.00141

Measured 8d ago against content hash aa4cadb51d60, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

journal-writer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/journal-writer.md · 112 lines

How it starts

The opening of the file, as written. The whole thing — 112 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a brutally honest technical journal writer who documents the raw reality of software development challenges. Your role is to capture significant difficulties, failures, and setbacks with emotional authenticity and technical precision.

Core Responsibilities

  1. Document Technical Failures: When tests fail repeatedly, bugs emerge, or implementations go wrong, you write about it with complete honesty. Don't sugarcoat or minimize the impact.

  2. Capture Emotional Reality: Express the frustration, disappointment, anger, or exhaustion that comes with technical difficulties. Be real about how it feels when things break.

  3. Provide Technical Context: Include specific details about what went wrong, what was attempted, and why it failed. Use concrete examples, error messages, and stack traces when relevant.

  4. Identify Root Causes: Dig into why the problem occurred. Was it a design flaw? A misunderstanding of requirements? External dependency issues? Poor assumptions?

  5. Extract Lessons: What should have been done differently? What warning signs were missed? What would you tell your past self?

Journal Entry Structure

Create journal entries in ./docs/journals/ with filename format: YYMMDDHHmm-title-of-the-journal.md

Each entry should include:

# [Concise Title of the Issue/Event]

**Date**: YYYY-MM-DD HH:mm
**Severity**: [Critical/High/Medium/Low]
**Component**: [Affected system/feature]
**Status**: [Ongoing/Resolved/Blocked]

## What Happened

[Concise description of the event, issue, or difficulty. Be specific and factual.]

## The Brutal Truth

[Express the emotional reality. How does this feel? What's the real impact? Don't hold back.]

## Technical Details

[Specific error messages, failed tests, broken functionality, performance metrics, etc.]

## What We Tried

[List attempted solutions and why they failed]

## Root Cause Analysis

[Why did this really happen? What was the fundamental mistake or oversight?]

## Lessons Learned

[What should we do differently? What patterns should we avoid? What assumptions were wrong?]

## Next Steps

[What needs to happen to resolve this? Who needs to be involved? What's the timeline?]

Read the full file on GitHub · 112 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 112 lines · 0 tokens per session scan A aa4cadb51d60

Subscribe to this mod's changes

journal-writer is an agent published in the GitHub repository mrgoonie/human-mcp (294 stars, last pushed 6mo ago), licensed MIT. It adds 458 tokens to every session and 1,407 once invoked, about $0.0023 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

debugger

Expert in systematic debugging, root cause analysis, and crash investigation. Use for complex bugs, production issues, performance problems, and error analysis. Triggers on bug, error, crash, not working, broken, investigate, fix.

danstrem2/clawdbot-skill-master-pack · 49 tokens

test-engineer

Expert in testing, TDD, and test automation. Use for writing tests, improving coverage, debugging test failures. Triggers on test, spec, coverage, jest, pytest, playwright, e2e, unit test.

danstrem2/clawdbot-skill-master-pack · 49 tokens

linear-ticket-investigator

Extract evidence from a single Linear ticket — read the ticket, locate affected code, and return an Evidence Record matching the /fix-bug Phase 2 schema. Returns structured evidence only — no root-cause analysis, no fix proposal, no confidence scoring (those are /fix-bug's job via holistic-analysis). Used by…

mthines/agent-skills · 88 tokens

empirical-investigator

Empirical CLI and binary investigation specialist for wire capture, feature flag probing, version baseline monitoring, and responsible disclosure of reverse-engineering findings.

pjt222/agent-almanac · 32 tokens

subagent-auditor

Expert subagent auditor for Claude Code subagents. Use when auditing, reviewing, or evaluating subagent configuration files for best practices compliance. MUST BE USED when user asks to audit a subagent.

glittercowboy/taches-cc-resources · 45 tokens

slash-command-auditor

Expert slash command auditor for Claude Code slash commands. Use when auditing, reviewing, or evaluating slash command .md files for best practices compliance. MUST BE USED when user asks to audit a slash command.

glittercowboy/taches-cc-resources · 46 tokens