zh-ai-coding-doc-templates

snippet

A vendor-neutral, reusable template for giving AI coding assistants consistent project context across any language, stack, or architecture.


Overview

A vendor-neutral, reusable template for creating an AI knowledge base that coding assistants (OpenCode, Claude Code, Codex CLI, Cursor, Windsurf) can consume to understand a project's context. Copy it into any project and AI assistants auto-discover the .ai/ directory.

What it does

  • Structured AI rules via .ai/rules.md — the single source of truth for assistant behavior.
  • Architecture docs, domain models, coding/testing/git standards, and Architecture Decision Records (ADRs).
  • Contextual knowledge — glossary, known issues, project history.
  • Reusable prompt templates for features, bugfixes, refactoring, and code review.

How it's built

  • Pure Markdown — no runtime code, no dependencies, no build tools.
  • Vendor neutral — works with any AI coding tool.
  • Framework neutral — applies to any language, stack, or architecture.
  • Intentionally lightweight — start small, add only what you need.
  • Practical over theoretical — every file is immediately usable.

status
[ACTIVE]
date
2026-07-16
tech
markdowngitai-tools

← back