agentleFS
ChurchCRMChurchCRM/CRM/.agents/skills/churchcrm/SKILL.md

churchcrm

Skill998 starsChanged yesterdayMITView on GitHub

ChurchCRM project-specific development skills covering architecture, API, database, frontend, security, plugins, testing, and workflows. Use when working on any ChurchCRM feature, bug fix, or migration.

The file

Files
SKILL.md

ChurchCRM Development Skills

These files apply to every agent family. Product floor is PHP 8.4+. Community plugins ship in the product. The plugin registry URL is CentralServices::PLUGIN_REGISTRY_URL.

Load skill-architecture.md only when adding or editing a skill.

Architecture & API

  1. Routing & Architecture
  2. Slim 4 Best Practices
  3. API Development
  4. Service Layer
SkillWhen to Use
Slim MVC SkillSlim apps under src/
Configuration ManagementSystemConfig
Settings PlacementWhere a setting lives, area admin hub
Volunteer Management v2Ministries / Volunteer v2 (full design: docs/design/volunteer-v2.md)
Member Portal Design/portal and themes (flow, screens, data: docs/design/member-portal.md)

Reports

SkillWhen to Use
ReportsPDF/CSV reports, mPDF, letterhead, statement downloads

Database

SkillWhen to Use
Database OperationsORM
DB Schema MigrationSchema / upgrade scripts

Frontend & UI

Row actions: table-action-menu.md. Settings UI: copy the Finance dashboard pattern (frontend-development.md).

SkillWhen to Use
Icon ManagementFont Awesome
Table Action MenuTable row actions
Frontend DevelopmentUI changes
Timezone HandlingEvent / kiosk time
Responsive Design GuidelinesLayout
Webpack & TypeScriptBundling
i18n & LocalizationWrap UI strings
Locale TranslationTranslation agents
Currency LocalizationMoney display
Error Reporting & Issue FilingError pages

Security

SkillWhen to Use
Authorization & SecurityRoles / EditSelf
Security Best PracticesEscaping / CSRF
Security Advisory ReviewGHSA
GitHub InteractionAdvisory publish

Plugins

SkillWhen to Use
Plugin SystemRuntime + registry constant
Plugin Registryapproved-plugins.json
Plugin DevelopmentAuthor a plugin
Plugin Create (Community)Submit a plugin
Plugin MigrationUpdate src/plugins/core/* when core APIs change
Plugin Security ScanIntake
Plugin ComplianceInstalled-plugin audit

Testing

SkillWhen to Use
Cypress TestingWriting and running specs, permission (gate) tests
CI & Test InfrastructurePHP/Nette test packages, test stack, red CI, shards, test database and seed, cleanup guard
Marketing Visual-Media PipelinePlaywright captures

MVC / PHP

SkillWhen to Use
Admin MVC MigrationConvert a page to Slim MVC
Groups MVC GuidelinesGroups
RefactorFeature refactor
PHP Best PracticesPHP / Perpl
Performance OptimizationQueries

Community feedback policy (Feature Proposals and RFC Reviews Discussions): docs/decisions/0003-rfc-community-prioritization.md.

Process

SkillWhen to Use
Git WorkflowCommit / push
Release ManagementRelease preparation and verification
Maintainer Review GatesReview a PR
PR ReviewStandards checklist
Church ReviewReview an issue from the church user's workflow
Stale Issue TriageRe-triage stale-closed issues
Dependabot PR Review/dependabot-review <PR>: npm or Composer upgrade review
PR Review FixAddress review comments
Skill architectureEdit a skill
PR Description GuidelinesTitle / body
Development WorkflowsLocal setup commands
Code StandardsAlways-on floor

Example Workflows

  • Review a PR: maintainer-review-gates.md → pr-review.md. Draft only.
  • Church-review an issue: church-review.md. Draft only.
  • Address PR comments: ../pr-review-fix.md → git-workflow.md
  • Add UI text: i18n-localization.md. locale:build runs on merge to master.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.