Skip to content

unclecatvn/agent-skills / skills/odoo-workflow

odoo-workflow

Unverified

Mandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix, refactor, "optimize", "clean code", "stick to base"), Odoo 16-19. Also when the user pastes an Odoo traceback or install/upgrade error (ParseError "cannot be located in parent view", "Field ... does not exist", missing xmlid) or asks where an Odoo model, field, method, view or xmlid is defined. Run BEFORE brainstorming or planning: Odoo design questions are answered by tracing the real source into a Context Brief (file:line), not by open-ended Q&A or memory. Resolves the Odoo runtime and version, loads the matching odoo-<major> pack, and closes with install, test, upgrade, i18n, security and hygiene checks before commit.

FileKindSize
SKILL.mdskill md18.3 KB
references/definition-of-done.mdmarkdown8.2 KB
scripts/odoo_trace.pyscript67.4 KB
templates/CLAUDE.mdmarkdown1.7 KB

templates/CLAUDE.md

View on GitHub
# Odoo project rules

<!-- Merge into the project's CLAUDE.md (and AGENTS.md for other agents). Adjust version and layout. -->

Odoo version: **18.0**. Addons roots, in `addons_path` order: `erp`, `erp-external`,
`erp-internal` (Enterprise). Each is its own git repository.

Machine-local runtime lives in `.claude/odoo.json` (gitignored), read by the `odoo-workflow`
helper:

```json
{"odoo_version": "18.0", "odoo_root": "/path/to/odoo/18.0", "conf": "/path/to/odoo/18.0/odoo.conf",
 "python": "/path/to/odoo/18.0/.venv/bin/python3", "dev_db": "v18_dev"}
```

## Every Odoo change

- Run the `odoo-workflow` skill first - before brainstorming or planning skills, which start
  from its Context Brief - then the Odoo 18 pack for the guide you need.
  No code without a Context Brief that cites `file:line` in the real source.
- Throwaway databases only (`scratch_*`, `upg_*`). Never install or upgrade modules on
  `v18_dev`, staging, or a customer copy unless asked by name.
- Stored-field renames, removals, and type or selection-key changes ship with a manifest version
  bump and a `migrations/<version>/` script.
- Bind `sudo()` results to `<name>_sudo`; never return them from public methods.
- Strings changed: regenerate `i18n/<module>.pot` and merge every `.po` (file names unchanged)
  before commit.

## Never

- `ponytail:` or "simplified for now" comments in this repo.
- `Co-Authored-By`, `Generated with`, or session links in commits or PR bodies.
  Disable them at the source once with the Claude Code `attribution` setting
  (`{"commit": "", "pr": ""}`, project or user level - see the agent-skills README).

## Commits

- Use the `odoo-commit` skill: `[TAG] module: description`, one module per commit, one commit
  and PR per repository.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall