brisal-process

Process, decisions, and agent infrastructure for the Brisal project.

This repo is consumed as a git submodule of the Brisal source project, mounted at <brisal>/.agents/. It holds the meta layer of Brisal — not the application source. Contents: architectural decisions, agent operating rules, feedback log, reusable skills, plans, and per-domain documentation that govern how the Brisal codebase is built and reviewed.

Layout

• decisions/ — ADRs (Architecture Decision Records), one file per decision, named NNNN-slug.md. See DECISIONS.md for the index.
• instructions/ — Language and tool conventions: rust.md, svelte.md, playwright.md, error-handling.md, code-review.md.
• feedbacks/ — Session learnings and post-mortems from real Brisal work, timestamped YYYY-MM-DD-HHMM-slug.md.
• skills/ — Reusable agent skills (e.g. domain-modeling for ADRs).
• tasks/ — plans/ (slices in flight), roadmap/ (forward look), archives/ (finished).
• docs/ — Per-domain documentation mirroring Brisal's crate layout (delegation, hooks, persistence, projects, provider, sessions, skills, src, src-tauri, tools, workspaces).
• INSTRUCTIONS.md — Top-level operational rules for AI agents. Overrides defaults.

How to use it

• Humans starting work on Brisal: read AGENTS.md, scan the DECISIONS.md index, then dive into the relevant docs/ slice.
• AI agents: start at AGENTS.md — it lists the read order and the rules that override defaults.

Submodule context

Mounted at <brisal>/.agents/ via git submodule. Paths in INSTRUCTIONS.md (e.g. .agents/DECISIONS.md, .agents/sessions/...) are relative to the Brisal project root, not to this submodule's root — leave them as-is.

Conventions

• ADR numbering: zero-padded NNNN, sequential, immutable once accepted. Supersede, never edit history.
• Markdown for prose. No emoji except in headings — matches project voice.
• No application source code in this repo. Source lives in the Brisal source repo; this repo only tracks how that source is built.