1.2 KiB
AI Artifacts Context
This context defines the shared language for the repository that houses agent-generated artifacts across projects.
Language
Artifact: An output created by an agent during or after work, kept because it may be useful later. Avoid: Generated file, output
Project: A named body of work that owns project-specific artifacts. Avoid: Repository, codebase, workspace
Project Key:
The lowercase directory basename used to identify a project under projects/.
Avoid: Project ID, slug, repo name
Spec: A project-specific description of intended behavior, design, or acceptance criteria. Avoid: Requirements doc, design note
Task: A project-specific unit of planned or completed work. Avoid: Todo, ticket
ADR: A project-specific record of an architectural decision that is costly to reverse and would be surprising without context. Avoid: Decision note, rationale
Wiki Entry:
A cross-project knowledge artifact intended to be found directly by name in the flat wiki/ directory.
Avoid: Knowledge page, note
Tag File:
An empty Markdown file in the flat tags/ directory whose name exists only to create graph clusters.
Avoid: Label, category, index