Contributing

agentic-fm is intended to grow through collaboration with the FileMaker developer community. Here's how you can help.

Ways to Contribute

Knowledge Base Articles

The more complete the knowledge base, the higher the quality of AI-generated code. Document FileMaker behaviors, nuances, and gotchas that AI commonly gets wrong. Add a Markdown file to agent/docs/knowledge/ with a matching entry in MANIFEST.md. Good topics: single pass loops, script trigger availabilty & use, server-side compatibility and other aspects unique to developing in FileMaker.

Bug Reports & Corrections

Found an error, omission, or a snippet that produces incorrect output? Open an issue and let us know.

Snippet Examples

Additional and updated fmxmlsnippet templates for step types not yet covered are among the most valuable contributions.

Editor & Workflow Support

The core toolchain is editor-agnostic (developed with Cursor). If you build support for a specific editor, IDE, or automation workflow, a pull request is welcome.

Webviewer & HR Converter

Improvements to the webviewer UI, the HR-to-XML converter, Monaco autocomplete definitions, or AI chat integration. If you modify step catalog entries, verify the converter handles the changes correctly.

Companion Script Improvements

The FileMaker scripts in filemaker/agentic-fm.xml are early versions. Better path handling, error reporting, and cross-platform support are all good targets.

Contribution Workflow

Follow the standard fork-and-pull-request workflow:

1

Fork the repository

Click the Fork button on the GitHub repo to create your own copy.

2

Create a feature branch

git checkout -b feature/your-improvement
3

Make your changes

Follow existing conventions. If adding snippet examples, ensure they match the structure in snippet_examples/steps/CONVENTIONS.md.

4

Submit a pull request

Push your branch and open a PR against main. For significant changes, open an issue first to discuss the approach.

Guidelines

  • Keep changes focused — one improvement per PR where possible
  • Test snippet examples by pasting them into FileMaker and verifying they work
  • Run validate_snippet.py on any new or modified fmxmlsnippet files
  • Follow the coding conventions in agent/docs/CODING_CONVENTIONS.md
  • Document any new context requirements or workflow changes

Questions?

Open a Discussion on GitHub or file an Issue.

Ready to bring AI into your FileMaker development?

agentic-fm is open source and free to use. Star the repo to follow development, or jump straight into the installation guide.

Installation Guide Star on GitHub