gui_agent CLAUDE.md

A project instruction file that tells a coding agent how to preserve context across work sessions. It defines project records, plans, decisions, milestones, and test logs.

In plain words
What is it for?
It helps manage long projects, record architecture and milestones, track tests, and recover the current state after a session ends.
Why use it?
It reduces the risk of losing project history or repeating decisions when a new session starts. It also gives the agent a consistent handoff process.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/leandre755/gui_agent/claude-md
Clone the repo
git clone --depth 1 https://github.com/leandre755/gui_agent
Per session 2,180 This file is loaded in full into every session.
When invoked 2,180 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 97% copy Near-identical to another mod 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 $0.02180 $0.02180
Opus 5 $0.01090 $0.01090
Sonnet 5 $0.00436 $0.00436
Haiku 4.5 $0.00218 $0.00218

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

Security

Grade A, and why

gui_agent CLAUDE.md 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 2d 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.

Origin

This is a copy

97% identical to gui_agent AGENTS.md — 4 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 221 lines

How it starts

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

Git-Context-Controller (GCC) Protocol

This protocol governs context persistence, architecture tracking, and session handoff mechanics. It must be strictly executed by the AI agent at specific session milestones.

<file_matrix> Acts as the global project registry. Contains high-level milestones, objective, chronological decision log, and an active index of valid plans. Step-by-step tactical implementation plan for complex, multi-session epics only. Factual technical changelog and precise transition state. Overwritten at the absolute end of every session to ensure seamless state-recovery in fresh chat environments. Persistent test execution log, tracking completed tests, results, bugs found, and fixes applied. Test backlog tracking all pending scenarios and test suites to be executed. </file_matrix>

<event_driven_protocols>

Read the full file on GitHub · 221 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. 2d ago First seen · 221 lines · 2,180 tokens per session scan A ed265567ba95

Subscribe to this mod's changes

gui_agent CLAUDE.md is an instructions file published in the GitHub repository leandre755/gui_agent (4 stars, last pushed 4d ago), licensed MIT. It adds 2,180 tokens to every session, about $0.0109 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to gui_agent AGENTS.md, differing in 4 lines, and is treated as a copy.

Related

Other instructions, from other repositories