read-memory-enhanced

Loads project memory, git history, specs, and pending plans before any codebase work begins.

Updated May 16, 2026
One-click install
npx skills add https://github.com/alimtvnetwork/img-pdf-v2 --skill read-memory-enhanced-alimtvnetwork
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read-memory-enhanced
Source: https://github.com/alimtvnetwork/img-pdf-v2/tree/main/.agents/skills/read-memory-enhanced
Command: npx skills add https://github.com/alimtvnetwork/img-pdf-v2 --skill read-memory-enhanced-alimtvnetwork

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents often start coding without understanding a project's conventions, past decisions, open questions, or in-flight plans, causing regressions and repeated mistakes. This Skill enforces a strict read-only onboarding protocol that loads the project's full institutional memory before any work begins. ## Core Features & Use Cases - Structured Memory Loading: Walks the .ai-memory/ folder recursively, covering CODE RED rules, user preferences, institutional knowledge indexes, pending plans, issues, and CI/CD failure history. - Git Context Inspection: Analyzes the last 10 commits via git log -n 10 --stat to understand recent file changes and architectural intent. - Ambiguity Handling: Surfaces open questions from ambiguous-questions/ folders and treats resolved ones as binding decisions, refusing to guess past blockers. - Tiered Read-Only Tooling: Uses cached Python readers, GitMap CLI, or native file tools with a strict ban on repository writes during reading. - Use Case: Before modifying a large spec-driven repository, run this protocol so the agent can cite the exact file behind every rule it enforces and list all pending plans from memory. ## Quick Start Ask the agent to run the read memory protocol and load the project context before starting any code changes.

Frequently Asked Questions about read-memory-enhanced

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent read project context before coding?

Run a structured onboarding protocol that walks the .ai-memory folder, reads what-to-read.md first, inspects the last 10 git commits, and loads specs and pending plans. The agent must confirm understanding before touching code.

What is the .ai-memory folder structure for AI agents?

It contains an index, strictly-avoid rules, user preferences, memory and plans indexes, pending and completed plans, issues, CI/CD issues, and ambiguity folders. Each file is read recursively so no institutional knowledge is skipped.

Can the agent write files while reading project memory?

No. The protocol enforces a total ban on repository writes during reading. Any scratch communication between sub-agents must go to an isolated folder in the system temp directory named after the repository.

What happens when an open ambiguity blocks a task?

The agent stops and surfaces the open ambiguity before doing any work instead of guessing past it. Resolved ambiguity files are treated as binding decisions and are never re-litigated.

Which tools accelerate reading large repositories?

A three-tier fallback applies: cached Python reader scripts first, then GitMap CLI commands like gitmap cat and gitmap find-files, and finally native file tools such as view_file and grep_search.