Skip to content

feat: add itkdev-validate-standards skill#29

Open
yepzdk wants to merge 3 commits intomainfrom
feature/itkdev-validate-standards
Open

feat: add itkdev-validate-standards skill#29
yepzdk wants to merge 3 commits intomainfrom
feature/itkdev-validate-standards

Conversation

@yepzdk
Copy link
Contributor

@yepzdk yepzdk commented Feb 26, 2026

Summary

  • Add itkdev-validate-standards skill for auditing projects against itk-dev Docker and development conventions from itk-dev/devops_itkdev-docker
  • Includes automated comparison via itkdev-docker MCP tools (detect, compare, fetch template content)
  • Provides a 9-area validation checklist: Docker Compose, server compose, environment, Taskfile, Symfony/PHP config, Composer, GitHub Actions, and miscellaneous files
  • Each area includes remediation tables and the skill generates a summary report

Test plan

  • Install the plugin and verify the skill appears in the skill list
  • Run the skill against a Symfony project and confirm all 9 validation areas are checked
  • Verify MCP tool integration works for automated comparison (Step 0)

@yepzdk yepzdk requested a review from cableman February 26, 2026 11:45
"check itk-dev standards", (3) reviewing PR for convention compliance,
(4) setting up a new itk-dev project, (5) upgrading Docker configuration.
Walks through 9 validation areas: MCP tool comparison, docker-compose,
server compose, environment, Taskfile, Symfony/PHP config, Composer,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Symfony/PHP config this would limit the usage to symfony projects or?


Before manual checks, attempt automated comparison using the
`plugin:itkdev-tools:itkdev-docker` MCP tools. These provide
file-level diffs against the canonical template.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The big question is how do we handle extra service etc. or would exceptions to the rules be handled in the projects memory files

- [ ] `phpfpm` uses `itkdev/php8.4-fpm:latest` (or appropriate PHP version)
- [ ] `mariadb` uses `itkdev/mariadb:latest`
- [ ] `nginx` uses `nginxinc/nginx-unprivileged:alpine`
- [ ] `worker` uses `itkdev/supervisor-php8.4:alpine` (matching PHP version)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Worker it only in this or some projects. Many default projects would use a docker-compose.override.yml file to add/unset services form the default setup.


#### Dev Profile Services

- [ ] `node`, `markdownlint`, `prettier` services have `profiles: [dev]`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Normally they would be added in docker-compose.override.yml


### Step 3 — Environment (`.env`)

Validate environment file conventions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is mainly for symfony projects only


---

### Step 4 — Taskfile.yml
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure we have a taskfile standard... may simple task required only. Link task compose, task drush, task console... based on project type

yepzdk added a commit that referenced this pull request Feb 27, 2026
Address PR #29 review feedback: remove Symfony-centric assumptions and
make the skill flexible for Symfony, Drupal, and generic project types.

- Add project type classification (symfony-*/drupal-*/generic) after Step 0
- Support documented project exceptions via CLAUDE.md
- Make worker service and dev profile services conditional in Step 1
- Restructure Taskfile checks into required/conditional/optional tiers
- Rename Step 5 to "Framework-Specific Config" with per-type checks
- Split GitHub Actions workflow list by project type
- Update verification report template with documented exceptions
Add skill for auditing projects against itk-dev Docker and development
conventions from itk-dev/devops_itkdev-docker. Includes automated MCP
tool comparison and 9-area manual validation checklist.
Align with the itkdev- prefix convention used by all other skills.
Address PR #29 review feedback: remove Symfony-centric assumptions and
make the skill flexible for Symfony, Drupal, and generic project types.

- Add project type classification (symfony-*/drupal-*/generic) after Step 0
- Support documented project exceptions via CLAUDE.md
- Make worker service and dev profile services conditional in Step 1
- Restructure Taskfile checks into required/conditional/optional tiers
- Rename Step 5 to "Framework-Specific Config" with per-type checks
- Split GitHub Actions workflow list by project type
- Update verification report template with documented exceptions
@yepzdk yepzdk force-pushed the feature/itkdev-validate-standards branch from c96eb4b to 63c3fe6 Compare February 27, 2026 12:09
@yepzdk yepzdk requested a review from cableman February 27, 2026 12:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants