Users start with Motif's Help, shared by the command line, window and documentation site. The plugin guides connected assistants; parser help explains diagnosis and FieldWorks modeling.
- Architecture and API: architecture, CLI API, generic record store, model surface, affix processes, sound authoring, parser surface, custom fields, writing systems.
- Proposal and Apply: Proposal contract, lifecycle, conflicts and rebase, applied log, review report, allomorph retirement, human judgment.
- Parser and grammar: grammar map, feature coverage, Parsimony evidence, Try a Word acceptance, corpus ingestion, parser help, handoff formats.
- Testing and release: changed-file tests, slow tests, agent plugin release smoke, release notes, configuration.
- Window and media: media boundary and the window decisions.
ADRs hold decisions in force. References combines cited sources and condensed engineering findings in one folder; the prepared Oracle pins those records.
The handoff/, release-notes/ and references/ paths are stable integration, release and Oracle paths. Update their consumers when a change is unavoidable.
- Change a decision in its existing ADR; git keeps its history. Reserve a new number for a new topic, and do not create supersession chains.
- Track open work in a GitHub issue, not a repository plan or register.
- Put a reusable finding in a condensed file under
references/with its source and limits. - Never commit grammar or FieldWorks project data; ADR 0002 gives the rule and named exception.
- The ADR crosswalk maps historical numbers to current decisions.