Contributing

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

Ways to Contribute

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.

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 workflow?

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