Menu
Use for Pydantic v2 validation errors, DSL parser/validator rejections, and API request validation issues in Rulesgen.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when adding, renaming, reordering, or linking Rulesgen public docs that flow to the tdm-docs Docusaurus site and tdspora.ai. Covers the import pipeline, sidebar/.order mechanics, the "link locally until published" rule, and the lychee link-check and docs-contract validation battery.
Use for authoring or updating Rulesgen documentation — public docs (`docs/public/`), repo-root design docs, contributor docs, sample READMEs, and the glossary. Produces testable, glossary-aligned, link-integral docs.
Use for testing Rulesgen documentation — executes Markdown code fences via Sybil, validates link integrity, lints glossary usage, and cross-checks docs against Settings, schemas, and routes.
Use for authoring, reviewing, or correcting natural-language → Python generation DSL rules for Rulesgen.
Use for implementing production-grade Rulesgen features or non-trivial code changes.
Use for FastAPI route, middleware, lifespan, dependency injection, or Problem Details response issues in Rulesgen.
| name | rulesgen-validation-debugging |
| description | Use for Pydantic v2 validation errors, DSL parser/validator rejections, and API request validation issues in Rulesgen. |
ValidationError raised in rulesgen/schemas/* or rulesgen/domain/models.py. Locate the offending field via the error loc tuple.rulesgen/compiler/parser.py. Reproduce with a minimal DSL snippet and a unit test in tests/unit/test_compiler.py.rulesgen/compiler/validator.py. Check whether the rejection is expected for safety; if so, document why; if not, narrow the validator rule.RuntimeSpec. Check rulesgen/compiler/runtime_spec.py and tests/unit/test_runtime_properties.py.rulesgen/api/dependencies.py, and the schema in rulesgen/schemas/.requirements/NL-to-Python-Generation-DSL.md describe this form?tests/contract/)?uv run pytest <targeted> and the existing tests in the same file (no regressions).tests/contract/test_problem_details.py patterns.rulesgen-security-reviewer.default= semantics differ from v1; verify against the v2 docs (use the context7 MCP if needed).from __future__ import annotations + Pydantic v2 requires explicit model_rebuild() in some forward-reference cases.