18 added, 13 removed. Audit A to A.
# Repository Agent Guidance
## Private and generated artifacts
- This is a public open-source repository. Treat its checkout as source-only
- unless the user explicitly requests repository development work.
+ This is a public open-source repository. Its working directory holds only this
+ repository's own source, tests, docs, and configuration. Anything generated for
+ the user rather than for the repo, along with its supporting files (builders,
+ renders, previews, inspection files, dependency links), goes in a per-run
+ temporary directory outside the working directory, and final artifacts go only
+ to an explicitly approved external or private destination.
- - Use a per-run temporary directory outside the checkout for personal or
- business artifacts and their supporting files.
- - Never place documents, spreadsheets, slides, PDFs, images, downloaded
- attachments, builders, renders, previews, inspection files, dependency
- links, or an `outputs/` directory under the checkout.
- - Put final artifacts only in an explicitly approved external or private
- destination.
- - The `outputs/` ignore rule is a safety net, not an approved storage
- location.
- - Explicitly requested source, test, documentation, or configuration changes
- to this repository remain normal repository work.
+ The `outputs/` ignore rule is a safety net, not an approved storage location.
Before staging or committing, inspect all untracked paths and confirm that no
personal or business artifacts are present.
+
+ ## Documented solutions and vocabulary
+
+ `docs/solutions/` holds documented solutions to past problems, covering bugs,
+ best practices, and workflow learnings, organized by category with YAML
+ frontmatter (`module`, `tags`, `problem_type`). Relevant when implementing or
+ debugging in an area a learning already covers.
+
+ `CONCEPTS.md` holds the shared vocabulary for this project: the entities,
+ named processes, and status concepts that carry a specific meaning here.
+ Relevant when orienting to the repo or discussing its concepts.