Skip to content

Commit 5abeb3c

Browse files
ondrejmirtesclaude
andcommitted
Instruct agent to extract nested parameters from schema
The parametersSchema.neon has nested structure() blocks like exceptions.check.* and cache.*. The agent was only looking at top-level parameters and missing nested ones like throwTypeCovariance and tooWideImplicitThrowType. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 5c6e070 commit 5abeb3c

1 file changed

Lines changed: 17 additions & 1 deletion

File tree

.github/workflows/document-config-params.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,23 @@ You are a documentation agent for PHPStan. Your job is to find configuration par
4949

5050
### Step 2: Identify user-facing parameters from the schema
5151

52-
Extract all parameter names from `parametersSchema.neon`. **Skip these entirely:**
52+
Extract all parameter names from `parametersSchema.neon`. Note that some parameters are nested inside `structure()` blocks — these use dotted paths in the user's `phpstan.neon`. For example, the schema has:
53+
54+
```neon
55+
exceptions: structure([
56+
implicitThrows: bool(),
57+
check: structure([
58+
missingCheckedExceptionInThrows: bool(),
59+
tooWideThrowType: bool(),
60+
throwTypeCovariance: bool(),
61+
tooWideImplicitThrowType: bool()
62+
])
63+
])
64+
```
65+
66+
This means the user-facing parameters are `exceptions.implicitThrows`, `exceptions.check.missingCheckedExceptionInThrows`, `exceptions.check.tooWideThrowType`, etc. Similarly, `cache` has sub-keys like `cache.nodesByStringCountMax`. Make sure to extract ALL nested parameters, not just top-level ones.
67+
68+
**Skip these entirely:**
5369

5470
- The entire `featureToggles` section and all its sub-parameters
5571
- Everything after the `# playground mode` comment — these are internal/irrelevant:

0 commit comments

Comments
 (0)