Skip to content

Workflows

Resume The Repo

  1. Read README.md.
  2. Read docs/index.md.
  3. Read the relevant active design page and any linked ADRs.
  4. Check git status --short --branch before making changes.

Update Design Docs

  1. Edit the canonical markdown page under docs/.
  2. Update docs/terminology/index.md if the change affects shared vocabulary.
  3. Update or add an ADR in docs/adr/ when the change records a durable design decision.
  4. Update docs/reference/repo-boundaries.md if the change affects the split between Odoo, ABS, and commercial-operations ownership.
  5. Rebuild the docs site from the repo root with python -m mkdocs build -f D:\github\dirac-odoo\mkdocs.yml.

Refresh Repo MCP Docs

  1. Run python D:\github\workspace-mcp\scripts\mcp_provision.py dirac-odoo.
  2. Preserve existing repo-authored agent/context docs unless explicit overwrite is intended.
  3. Refine docs/agent/ and docs/context/ so they describe the real repo rather than generated defaults.

Wrap The Repo

  1. Remove transient logs or local scratch artifacts created during the session.
  2. Append session context to .session.md.
  3. Stage intended changes, commit them, and push to the tracked remote.