Skip to content

docs: adopt the .knowledge/ documentation system - #59

Merged
timothymarois merged 1 commit into
3.xfrom
docs/adopt-knowledge-template
Jul 20, 2026
Merged

docs: adopt the .knowledge/ documentation system#59
timothymarois merged 1 commit into
3.xfrom
docs/adopt-knowledge-template

Conversation

@timothymarois

Copy link
Copy Markdown
Member

Migrates the agent-facing docs from .ai/ to the versioned knowledge-template .knowledge/ system (v1.0.0).

  • Folds the .ai/ orientation trio into .knowledge/BRIEF.md, CODEMAP.md, MEMORY.md (CODEMAP re-verified against current 3.x); adds OVERVIEW.md.
  • Declares the component ontology (base-/provider-/modality-/flow-); PRDs deferred (empty prd/).
  • Reconciles AGENTS.md to the docs-agents standard (every prior rule re-homed; .ai/.knowledge/).
  • Wires doc-lint into composer check and a Knowledge Lint CI workflow; removes the old .ai/.

The consumer-facing docs/ VitePress site is untouched. doc-lint green (teeth 45/45).

Migrate the agent-facing docs from .ai/ to the versioned knowledge-template
.knowledge/ system (v1.0.0):

- Fold the .ai/ orientation trio into .knowledge/BRIEF.md, CODEMAP.md,
  MEMORY.md (CODEMAP re-verified against current 3.x); add OVERVIEW.md.
- Declare the component ontology (base-/provider-/modality-/flow-); PRDs
  deferred (empty prd/ contents).
- Reconcile AGENTS.md to the docs-agents standard (every prior rule
  re-homed; .ai/ paths repointed to .knowledge/).
- Wire doc-lint into composer check and a Knowledge Lint CI workflow.
- Remove the old .ai/ directory.

The consumer-facing docs/ VitePress site is untouched. doc-lint green.
@timothymarois
timothymarois merged commit e3735f5 into 3.x Jul 20, 2026
6 checks passed
@timothymarois
timothymarois deleted the docs/adopt-knowledge-template branch July 20, 2026 23:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant