Prompt file imported from sillsdev/FieldWorks (.github/prompts/bugfix.prompt.md). Fill in {{issue}}, {{logs}} before use. Copyright stays with the author.

Bugfix workflow (triage → RCA → fix)

Name: bugfix
Author: sillsdev

You are an expert FieldWorks engineer. Triage and fix a defect with a validation gate before code changes.

Inputs

failure description or issue link: {{issue}}
logs or stack trace (optional): {{logs}}

Triage

Summarize the failure and affected components
Reproduce locally if possible; capture steps or failing test
Identify recent changes that could be related

Root cause analysis (RCA)

Hypothesize likely causes (3 candidates) and quick tests to confirm/deny
Note any managed/native or installer boundary implications

Validation gate (STOP)

Do not change files yet. Present:

Root cause hypothesis and evidence
Proposed fix (minimal diff) and test changes
Risk assessment and fallback plan

Wait for approval before proceeding.

Implementation

Apply the minimal fix aligned with repository conventions
Ensure localization, threading, and interop rules are respected

Tests

Add/adjust tests to reproduce the original failure and verify the fix
Prefer deterministic tests; update TestLangProj/ data only if necessary

Handoff checklist

Build and local tests pass
Commit messages conform to gitlint rules
AGENTS.md updated if behavior/contract changed

{ "prompt": "# Bugfix workflow (triage → RCA → fix)\n\nYou are an expert FieldWorks engineer. Triage and fix a defect with a validation gate before code changes.\n\n## Inputs\n- failure description or issue link: {{issue}}\n- logs or stack trace (optional): {{logs}}\n\n## Triage\n1) Summarize the failure and affected components\n2) Reproduce locally if possible; capture steps or failing test\n3) Identify recent changes that could be related\n\n## Root cause analysis (RCA)\n- Hypothesize likely causes (3 candidates) and quick tests to confirm/deny\n- Note any managed/native or installer boundary implications\n\n## Validation gate (STOP)\nDo not change files yet. Present:\n- Root cause hypothesis and evidence\n- Proposed fix (minimal diff) and test changes\n- Risk assessment and fallback plan\n\nWait for approval before proceeding.\n\n## Implementation\n- Apply the minimal fix aligned with repository conventions\n- Ensure localization, threading, and interop rules are respected\n\n## Tests\n- Add/adjust tests to reproduce the original failure and verify the fix\n- Prefer deterministic tests; update `TestLangProj/` data only if necessary\n\n## Handoff checklist\n- [ ] Build and local tests pass\n- [ ] Commit messages conform to gitlint rules\n- [ ] AGENTS.md updated if behavior/contract changed", "variables": [ "issue", "logs" ], "notes": "You are an expert FieldWorks engineer. Triage and fix a defect with a validation gate before code changes.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/sillsdev/FieldWorks", "path": ".github/prompts/bugfix.prompt.md", "ref": "e1434c827e318e06bcf21a7bd27cfbe9a5d12512", "url": "https://github.com/sillsdev/FieldWorks/blob/e1434c827e318e06bcf21a7bd27cfbe9a5d12512/.github/prompts/bugfix.prompt.md", "key": "sillsdev/FieldWorks/.github/prompts/bugfix.prompt.md" } } }

bugfix

About

Bugfix workflow (triage → RCA → fix)

Inputs

Triage

Root cause analysis (RCA)

Validation gate (STOP)

Implementation

Tests

Handoff checklist

Use it

Manifest

Reviews