chore: preserve root worktree documents

2026-08-31 15:34:55 +02:00
parent b5db0cd3c1
commit fa7380b3a3
8 changed files with 1021 additions and 80 deletions
@@ -0,0 +1,25 @@
+# Domain documentation
+
+ThothII uses a single domain context.
+
+## Before exploring
+
+Read:
+
+- `CONTEXT.md` for the canonical domain vocabulary;
+- relevant ADRs under `docs/adr/`, when present.
+
+Missing documents are not an error. Domain terms and ADRs are created only when an
+actual decision makes them necessary.
+
+## Vocabulary
+
+Use the canonical terms defined in `CONTEXT.md`. Avoid introducing synonyms for
+concepts already defined there.
+
+When a required concept is absent, use `domain-modeling` to clarify and record it.
+
+## Architectural decisions
+
+If proposed work contradicts an existing ADR, surface the conflict explicitly rather
+than overriding the decision silently.
@@ -0,0 +1,33 @@
+# Issue tracker: GitHub
+
+Issues and specifications for this repository live in GitHub Issues. Use the `gh` CLI
+for all operations.
+
+## Repository
+
+- Repository: `mptyl/ThothII`
+- URL: https://github.com/mptyl/ThothII
+- Pull requests as a triage surface: no
+
+## Conventions
+
+- Create issues with `gh issue create`.
+- Read issues and comments with `gh issue view`.
+- Apply labels with `gh issue edit`.
+- Record resolutions in a comment before closing an issue.
+- Refer to issues by their linked title in user-facing documentation, not only by
+  number.
+
+## Wayfinding operations
+
+- A Wayfinder map is an issue labelled `wayfinder:map`.
+- Decision tickets are child issues labelled `wayfinder:research`,
+  `wayfinder:prototype`, `wayfinder:grilling` or `wayfinder:task`.
+- Use native GitHub sub-issues and issue dependencies when available.
+- If native sub-issues are unavailable, use a task list in the map and add
+  `Part of #<map>` to each ticket.
+- If native dependencies are unavailable, add `Blocked by: #<issue>` to the ticket.
+- An open, unassigned and unblocked child issue belongs to the frontier.
+- Claim a ticket by assigning it before beginning work.
+- Resolve a ticket by recording the decision in a comment, closing it and adding a
+  linked one-line summary to the map.
@@ -0,0 +1,9 @@
+# Triage labels
+
+| Canonical role    | GitHub label      | Meaning                                       |
+| ----------------- | ----------------- | --------------------------------------------- |
+| `needs-triage`    | `needs-triage`    | The issue still needs evaluation              |
+| `needs-info`      | `needs-info`      | More information is required                  |
+| `ready-for-agent` | `ready-for-agent` | Ready for autonomous agent work               |
+| `ready-for-human` | `ready-for-human` | Requires human intervention or implementation |
+| `wontfix`         | `wontfix`         | Will not be actioned                          |