Skip to content
TakoAPI
Back to skills

agent-context-system

by andreagriffiths11

Coding Agents & IDEs
566Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

A persistent local-only memory system for AI coding agents.

Description

What This Skill Does

A two-file convention for giving AI coding agents persistent memory across sessions. AGENTS.md holds committed project knowledge shared with the team; .agents.local.md is a gitignored personal scratchpad that grows session by session. No plugins, servers, or background processes required.

Unlike tool-specific memory features, the two-file convention works across Claude Code, Cursor, Copilot, and Windsurf in the same project without any additional tooling.

When to Use It

  • Preserving project context so agents don't cold-start each session
  • Sharing architecture patterns and gotchas with teammates via git
  • Logging dead ends so agents don't retry approaches that already failed
  • Coordinating parallel subagents that all share the same project knowledge
  • Gradually promoting recurring session learnings into permanent project docs

Example Workflow

INPUT

User starts a new coding session on an existing project

AGENT
  1. 1

    Agent reads AGENTS.md for committed project patterns, commands, and boundaries

  2. 2

    Agent reads .agents.local.md for personal preferences, past dead ends, and session logs

  3. 3

    Agent completes the task using accumulated context from both files

  4. 4

    Agent proposes a session log entry to the user before appending to .agents.local.md

  5. 5

    Agent writes the approved entry and flags any patterns that have recurred across 3+ sessions as ready to promote

OUTPUT

Session knowledge is logged locally; stable patterns are flagged for the user to promote into AGENTS.md

Installation

clawhub install andreagriffiths11/agent-context-system

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links