pokeswift-extractor-contract-change

Solid

Investigate, implement, and validate PokeSwift extraction or shared-contract changes without breaking the source-driven pipeline. Use when work touches `PokeExtractCLI`, `PokeDataModel`, `PokeContent`, generated `Content/Red` artifacts, or any bug where the issue may be in extracted data, schema shape, content loading, or extractor-to-runtime contract drift.

Data & Documents 348 stars 37 forks Updated 2 months ago

Install

View on GitHub

Quality Score: 75/100

Stars 20%
85
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
0
Description 5%
100

Skill Content

# PokeSwift Extractor Contract Change Read [AGENTS.md](../../../AGENTS.md) and [SWIFT_PORT.md](../../../SWIFT_PORT.md) before changing milestone-sensitive behavior. Treat generated content as evidence, not authoring surface. Prefer fixing the first broken contract layer instead of compensating in runtime code. ## Workflow 1. Define the failing contract. Capture the exact value or shape that is wrong: missing dialogue ID, wrong warp/checkpoint, broken map script, bad trainer manifest, missing audio cue metadata, stale item/species/move field, or loader decode mismatch. 2. Trace the first diverging layer. Use this order: `pret/pokered asm/data -> PokeExtractCLI -> Content/Red -> PokeDataModel/PokeContent -> PokeCore/PokeUI`. Fix the first layer that differs from the expected source-driven result. 3. Pick the right ownership boundary. If the extracted value is wrong, change `PokeExtractCLI`. If the extracted value is right but the shared model cannot represent it, change `PokeDataModel` first. If the model is right but loading or validation is wrong, change `PokeContent`. Only change `PokeCore` or `PokeUI` after the upstream contract is correct. 4. Regenerate instead of patching artifacts. After extractor changes, run `./scripts/extract_red.sh`. Never hand-edit `Content/Red/**` as the fix. 5. Validate upstream first, then downstream. Run focused `PokeExtractCLITests` and `PokeContentTests`. Then run the smallest runtime or UI tests tha...

Details

Author
Dimillian
Repository
Dimillian/PokeSwift
Created
2 months ago
Last Updated
2 months ago
Language
Assembly
License
None

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Solid

superdoc-redlines

CLI tool for AI agents to apply tracked changes and comments to DOCX files using ID-based editing

28 Updated 3 months ago
yuch85
Code & Development Featured

swift-concurrency

Diagnose data races, convert callback-based code to async/await, implement actor isolation patterns, resolve Sendable conformance issues, and guide Swift 6 migration. Use when developers mention: (1) Swift Concurrency, async/await, actors, or tasks, (2) "use Swift Concurrency" or "modern concurrency patterns", (3) migrating to Swift 6, (4) data races or thread safety issues, (5) refactoring closures to async/await, (6) @MainActor, Sendable, or actor isolation, (7) concurrent code architecture or performance optimization, (8) concurrency-related linter warnings (SwiftLint or similar; e.g. async_without_await, Sendable/actor isolation/MainActor lint).

1,509 Updated 3 weeks ago
AvdLee
AI & Automation Featured

agent-md-refactor

Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.

1,887 Updated 2 months ago
softaworks
AI & Automation Featured

veomni-develop

VeOmni-specific checklist for feature development and refactoring. Covers impact analysis across modalities, trainer hierarchy, data pipeline, and distributed code. Use before implementing any non-trivial change. For model-specific or ops-specific work, use veomni-new-model or veomni-new-op instead. Trigger: 'add feature', 'implement', 'refactor', 'reorganize', 'new capability'.

1,946 Updated today
ByteDance-Seed
Testing & QA Solid

openspec-apply-change

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

32 Updated 1 months ago
saadshahd