Open Source Framework

AI Development
Framework

Persistent AI memory for growing projects

A reusable template for AI-assisted development. The AI maintains a persistent wiki that tracks both knowledge and codebase context — so it never loses context as your project grows.

6 AI Tools Supported
2 Agents
11 Built-in Workflows

Why Use This Framework?

AI coding assistants are powerful — but they lose context. This framework fixes that.

Context Loss at Scale

As projects grow, AI assistants forget architecture decisions, coding conventions, and prior discussions. Every session starts from scratch.

Scattered Documentation

Knowledge lives in chat logs, comments, and developers' heads. There's no single, structured source of truth the AI can reference.

Inconsistent Code Changes

Without documented conventions and patterns, the AI produces code that conflicts with existing architecture and style.

The AI Development Framework solves this through:

1

Persistent Wiki

AI-maintained knowledge base that compounds over time — capturing decisions, patterns, and context.

2

Structured Workflows

Defined processes for ingesting knowledge and making code changes — ensuring consistency and quality.

3

Multi-Tool Support

Works with GitHub Copilot, Claude, Cursor, Windsurf, Cline, and Codex — one config, all tools.

How It Works

Two workflows — knowledge ingestion and code changes — both feed the wiki

You add a source to raw/

Drop documents, research, or specs into the raw/ folder for ingestion.

You request a code change

Ask the AI to implement a feature, fix a bug, or refactor — in natural language.

Knowledge Workflow

  • AI reads the source document
  • AI discusses key takeaways
  • AI creates wiki pages (sources, entities, concepts)

Code Workflow

  • AI reads wiki first (conventions, architecture, modules)
  • AI makes the change (consistent with existing patterns)
  • AI updates wiki after (modules, architecture, log)

Wiki (Living Knowledge Base)

wiki/index.md · wiki/log.md · wiki/overview.md

The wiki compounds over time. Every source ingested and every code change enriches it.

Core Principles

Two disciplines govern every agent action

Wiki Discipline

  • The wiki is the product — not the code, not the chat
  • Compound, don't repeat — build on existing pages
  • Flag conflicts explicitly — use callouts for contradictions
  • Cross-reference aggressively — link related concepts
  • Human curates, LLM maintains — you approve, AI writes

Coding Discipline

  • P1. Think Before Coding — State assumptions, surface interpretations, stop when confused
  • P2. Simplicity First — No unrequested features or abstractions; prefer the 50-line rewrite over the 200-line patch
  • P3. Surgical Changes — Touch only what the task requires; match surrounding style
  • P4. Goal-Driven Execution — Plans use the format: Step → verify: check

Agent Model

A single developer agent with modular skills, plus a read-only exploration agent

Agent 1

Developer Agent

Handles all code and wiki changes through seven modular skills applied in sequence

Agent 2

Exploration Agent

Read-only agent for searching the codebase and answering questions — never modifies files or runs commands

Developer Agent Skills

Skill Purpose
Plan Read requirements, identify affected wiki pages, break work into tasks with verify steps
Implement Write code following conventions, match existing patterns, create tests
Test Run test suite, verify changes, fix failures
Wiki Sync Update wiki pages, run Sync Gate, maintain index/log/overview
Review Lint wiki, check code↔wiki consistency, flag contradictions
Clean Safely delete orphan/deprecated/unused wiki pages
Commit Stage files, write structured commit messages, push to remote

Skills are applied in sequence during the Post-Change Pipeline — the mandatory 5-step process after every code change.

Project Structure

Everything has a place — sources stay immutable, wiki is AI-maintained

raw/                  # Your source documents (immutable)
wiki/                 # AI-maintained pages (don't edit manually)
  sources/            # Summaries of ingested documents
  entities/           # People, orgs, products, tools
  concepts/           # Ideas, frameworks, patterns
  analyses/           # Comparisons, syntheses
  architecture/       # System design, data flows
  modules/            # One page per component/service
  decisions/          # Architecture Decision Records
  conventions/        # Coding standards, project patterns
  index.md            # Master catalog of all pages
  log.md              # Chronological operation record
  overview.md         # High-level synthesis
AGENTS.md             # Schema — the single source of truth
scripts/              # Validation and maintenance tools

Quick Start

Three ways to get started — pick the one that fits

Option A: GitHub Template

Click "Use this template" on the GitHub repo — creates a new repo with the framework pre-loaded.

Use Template

Option B: Setup Script

Run the setup script in your existing project. It creates all directories and files, skipping any that already exist.

# Linux / macOS curl -sL https://raw.githubusercontent.com/ thongton11314/agent-coding-template/ main/scripts/setup.sh | bash
# Windows (PowerShell) irm https://raw.githubusercontent.com/ thongton11314/agent-coding-template/ main/scripts/setup.ps1 | iex

Option C: Tell Your AI

In any AI chat inside your project, just say:

"Clone github.com/thongton11314/ agent-coding-template and run scripts/setup.ps1 (or setup.sh) to install the AI development framework into this project."

The AI runs the setup script → framework is installed → AI reads AGENTS.md → ready.

Supported AI Tools

Six platforms are supported out of the box — all config files point to AGENTS.md as the single source of truth

GitHub Copilot

.github/copilot-instructions.md
Auto-loaded

OpenAI Codex

AGENTS.md
Auto-loaded

Claude Code

CLAUDE.md
Auto-loaded

Cursor

.cursorrules
Auto-loaded

Windsurf

.windsurfrules
Auto-loaded

Cline

.clinerules
Auto-loaded

Key Commands

Natural language commands for your AI assistant

Ingest a Source

"Ingest raw/my-article.md"

Ask a Question

"What does the wiki say about X?"

Health Check

"Lint the wiki"

Create Analysis

"Compare X and Y across sources"

Validation & Customization

Built-in health checks and full extensibility

Wiki Health Check

Run the validation script to catch issues early:

pwsh scripts/validate-wiki.ps1 # Windows bash scripts/validate-wiki.sh # Linux/macOS
  • Missing frontmatter detection
  • Broken wikilink checking
  • Orphan page identification
  • Filename convention enforcement
  • Index coverage verification
  • Stale source_paths warnings

Customize Everything

All conventions live in AGENTS.md. Update once — works everywhere.

Page Types

Add new wiki categories

Frontmatter

Change metadata fields

Workflows

Adjust for your team

Conventions

Add domain-specific rules

Ready to Scale Your AI Development?

Stop losing context. Start compounding knowledge. Install the AI Development Framework and give your coding assistant permanent memory.