Diew

Diew / living-docs

Public

A structured template for AI coding agents. Three markdown layers: agent.md for session context, docs/ for project knowledge, and a governance registry that tells the agent which file owns what rule. The agent reads before acting, updates after — on human request only.

14
0
100% credibility
Found May 15, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
AI Summary

A methodology for using AI agents to maintain up-to-date markdown documentation that captures project rules, standards, and knowledge for consistent coding sessions.

How It Works

1
🔍 Discover Living Docs

You hear about a simple way to stop repeating project details to your AI helper every time you code together.

2
💡 Decide to set it up

You copy a special starting instruction and give it to your AI helper for your project.

3
Choose your project type
🆕
New project

AI creates a clean set of notes from scratch to guide future work.

🔄
Existing project

AI reviews your current code first and pulls out key rules into helpful notes.

4
AI builds your guides

Your AI helper quickly makes a project guide and a folder of notes that capture all the important rules and checklists.

5
📖 Start a coding session

Next time you want to build or fix something, you tell your AI to read the guides first before starting.

6
🔧 Work on your task

Your AI uses the guides to do the job right, following your project's rules without mistakes.

7
📝 Update the notes

After finishing, you ask the AI to add what was learned or changed to keep the guides fresh.

🎉 Knowledge grows forever

Your project now has living guides that stay accurate and helpful for every future session, saving you time forever.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is living-docs?

Living Docs is a markdown template system that structures project knowledge for AI coding agents, using layered docs for session context, rules, and a governance registry mapping tasks to relevant info. It solves the drudgery of re-pasting conventions every AI session—agents read docs before acting and update them after tasks, but only on explicit human approval to avoid propagating errors. Developers get a persistent, agent-maintained knowledge base that compounds accuracy over time, with prompts like "read relevant docs first" or "run a doc sweep."

Why is it gaining traction?

Unlike one-off prompts or static LLM wikis, Living Docs enforces one-file-per-rule governance, structured output for agents, and workflows like zero-loss refactors or code audits that keep docs and code in sync without duplication. The hook is dead-simple habits: prefix tasks with doc reads, suffix with sweeps—agents handle file routing via the registry, flagging stubborn facts or violations automatically. It turns AI sessions into reliable, memory-persistent coding, echoing living documents meaning for GitHub LLM structured output setups.

Who should use this?

AI-heavy solo devs or small teams building web apps with tools like Cursor or Claude, especially full-stack folks managing evolving rules across features. Ideal for those auditing brownfield codebases or bootstrapping greenfield projects via agent prompts. Skip if you're not delegating code changes to LLMs daily.

Verdict

Worth bootstrapping for AI coding agent users—solid concept with clear prompts and safeguards, despite 14 stars and 1.0% credibility signaling early maturity and thin validation. Test on a side project; the human-checkpoint discipline alone justifies it over ad-hoc sessions.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.