From 2ab7be37c71122f199e8b28202c7677b080d3f77 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felipe=20Say=C3=A3o=20Lobato=20Abreu?=
 <github@mentordosnerds.com>
Date: Tue, 20 Oct 2026 17:30:28 -0300
Subject: [PATCH] chore: ignore Finder metadata and clarify validation

---
 .changelog/ignore-finder-metadata.md |   6 ++++++
 .gitignore                           |   1 +
 DESIGN.md                            |   2 +-
 guides/.DS_Store                     | Bin 6148 -> 0 bytes
 guides/body/.DS_Store                | Bin 6148 -> 0 bytes
 5 files changed, 8 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/ignore-finder-metadata.md
 delete mode 100644 guides/.DS_Store
 delete mode 100644 guides/body/.DS_Store

diff --git a/.changelog/ignore-finder-metadata.md b/.changelog/ignore-finder-metadata.md
new file mode 100644
index 0000000..7deb81b
--- /dev/null
+++ b/.changelog/ignore-finder-metadata.md
@@ -0,0 +1,6 @@
+---
+category: fixed
+type: patch
+---
+
+Remove tracked Finder metadata and ignore .DS_Store files throughout the repository.
diff --git a/.gitignore b/.gitignore
index a4cdf71..756d9dd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 /vendor/
 /.agents/
+.DS_Store
diff --git a/DESIGN.md b/DESIGN.md
index aa0f080..f253376 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -32,7 +32,7 @@ Runtime images live in `data/` so excluding consumer documentation from a Compos
 
 ## Validation
 
-Install the development tool with `composer install --no-scripts`, then run `php tests/generate-fixture.php`. Composer allows only the official `phpdocumentor/shim` plugin, which installs the signed phpDocumentor PHAR; no runtime dependency is added to template consumers. The CI matrix renders the fixture with PHP 8.3, 8.4 and 8.5 from both the checkout and a Git archive, and actionlint validates the workflow. The PHAR's bundled dependencies are outside Composer's dependency-audit coverage; use this build tool only with trusted project sources.
+Install the development tool with `composer install --no-scripts`, then run `php tests/generate-fixture.php` and `php tests/verify-consumer-skill.php`. The specifically approved `phpdocumentor/shim` plugin installs the signed phpDocumentor PHAR; no runtime dependency is added to template consumers. The separately approved `llm/skills` plugin synchronizes the contribution skill according to `skills.json`, including when `--no-scripts` is used. The CI matrix renders both fixtures with PHP 8.3, 8.4 and 8.5 from the checkout and a Git archive, and actionlint validates the workflow. The PHAR's bundled dependencies are outside Composer's dependency-audit coverage; use this build tool only with trusted project sources.
 
 Generate the fixture from `tests/fixture` with phpDocumentor 3:
 
diff --git a/guides/.DS_Store b/guides/.DS_Store
deleted file mode 100644
index 7beed2ebb479fef839fa42099b1b405297fadc93..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHKK~BR!44f?yYSkk3$Z<cwp}Zhe;RXFbl@<X~LMk8!Zn^L*&U}mUdR2AXgcCvt
z*^)gQuf6L`qBsk{E!*t^m;)G71xFK_9+7#`6B$L%jOb*I>VC1>H1+Nz(j0%40eN;A
zN;KHwEq#8|_rtlmDT=acO8VqwxSoA{-lX%}Z|8RphwsLksW`_Yo=^pQm+p<L<N1O8
zlQrt5w}vDptwY{>Oz?tNJfp>i*m87K&FG>(YM`c`^#&^IiA?MBQlE)2U<?=oKg|Gp
zw#ay@Xx11o28@9{1M+?FRKYxArx-pRG~oz9%;*lnarmbqdT|i*h@B!m6sM^~O?B~z
z;WV9oALH_foua10g`K%h+}XtwiVM5b??X6Tu4vX6Fa}Zv&h&CF{r`6O{GTS-l`&up
z{3`}rR;-F8Zz=ZHlbe%X>#1w1h{Sb@`xFjBD`u>;;!A1}`n?Q@dBjeU9*X@41RBg3
I1Ha0^7mtTvcmMzZ

diff --git a/guides/body/.DS_Store b/guides/body/.DS_Store
deleted file mode 100644
index 427fd028d6d4918e45ee777a9d73304dc37ab93b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHLOHRW;47F(%m0-~&%Q*t&1Zfpc&<mhaL>CRoru(@VYp%t6_7pl0SR#aMY36zS
z87EIloQa6&`nX$)EJS3EK~yReLi42Sq6E{a+~e@H+&m2ZII+oJHSyXT>E%(L<@o9P
z^SQ4dx^8<Iwy-hh_Uh$zRr_~8`p5k_H{@GpGRj`Yx~krNc)qDw^7>)2V)54XZdflQ
z7zhS}fnXpQAOq;xl=-D&%)vk~5DdIC!1qJKAhrdwqrEyX*%1KPz-$8DzHNbt24Gt-
zJHi4{PX&6amLrCGI_#;$wFR@Ir;A!;>{BYA4lioeVNVt=+B(J@3<Lu;12bPP*#B|r
zJUv2nP^^N1VBlXfpiQ^w*0{yeTff{adu_tF$DlASQ-MIYRt&UOj0OLXU7OSWi8}mk
W!R*LgXt#7=d<YmJF$Dv^z`z?QvpW_5