submit_candidate_decision
Record a newly discovered engineering convention for human review. Candidates require approval before being served to other agents.
Instructions
Record a new engineering convention you discovered while working — for human review.
Call this when you find an undocumented convention, a tricky gotcha, or a preferred
pattern that Metatron did not already know but future agents should. It is stored as
an uncurated CANDIDATE: a human maintainer must approve it in the Metatron UI or CLI
before it becomes canonical and is served to other agents. Nothing you submit here is
auto-promoted.
Returns the new candidate decision's id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pattern | Yes | The concrete rule or guideline, stated imperatively (e.g. "Use internal.http for outbound calls, not the requests library"). | |
| scope | Yes | Where the rule applies: a file path, directory/glob, or architectural layer (e.g. "src/services/**"), or "global". | |
| rationale | Yes | Why the convention exists — the problem or bug it prevents (e.g. "flaky network caused phantom 5xx errors; the internal client retries"). | |
| confidence | No | How strongly the team holds this convention. | medium |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |