First commit

projects/ai-artifacts/CONTEXT.md

@@ -0,0 +1,38 @@
+# 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
+

projects/ai-artifacts/adr/0001-top-level-artifact-layout.md

@@ -0,0 +1,4 @@
+# Top-level artifact layout
+
+Agent-generated artifacts are organized with a hybrid layout: `projects/<project>/...` holds project-specific artifacts, while `wiki/` and `tags/` hold cross-project Markdown files in strictly flat directories.
+This keeps project-bound work local to its project, keeps reusable knowledge directly discoverable, and uses empty tag files only to form Obsidian graph clusters.