Replace prose reference files with structured Platform API#14
Merged
discreteds merged 43 commits intomainfrom Apr 27, 2026
Merged
Replace prose reference files with structured Platform API#14discreteds merged 43 commits intomainfrom
discreteds merged 43 commits intomainfrom
Conversation
Defines a structured pseudocode library to replace the duplicated prose-based reference system (platform-mappings.md + 5 *-tools.md files) with typed PlatformSpec dictionaries, canonical operation enums, and deterministic lookup functions. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
ClawHub URL was clawhub.dev (wrong), corrected to clawhub.ai. Auth/publish commands updated from fabricated `openclaw auth login` / `openclaw plugins publish` to actual ClawHub CLI (`clawhub login`, `clawhub package publish`). Install syntax corrected to `openclaw plugins install clawhub:<pkg>`. Found by Codex adversarial review of the platform API restructure spec. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
14 tasks covering: platform-api.md creation, 6 PlatformSpec files, subagent-dispatch.md prose relocation, consumer updates (GEMINI.md, AGENTS.md, CLAUDE.md, 6 rubric YAMLs, CI, patterns, CONTRIBUTING), and old file deletion. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
claude-code, gemini-cli, codex, cursor, antigravity, openclaw
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace LOOKUP["..."]["platform"] patterns with REGISTRY[platform].* property paths and strip_fields()/tool_name()/supported_tools() function calls throughout all 6 platform rubric YAMLs and rubric-framework.md. Also update *-tools.md file references to lib/references/platforms/*.md paths. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Removes platform-mappings.md and 5 *-tools.md files, replaced by platform-api.md + 6 structured PlatformSpec files in platforms/. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Updates UPSTREAM.md re-seeding instructions and SKILL.md external references to point to the new platform API structure. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
SkillsMP.com and Smithery.ai are not verified in the researched Codex platform docs. Only $skill-installer and direct GitHub URL install paths are documented. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Defines how to align rubric check pseudocode with the Platform API: fix tool_name() calls, inline opaque functions, unify synonyms, and document the pseudocode/prose decision boundary. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- remaps_claude_tools inline now resolves canonical ops to native names via tool_name() before checking for remapping (Codex review finding) - Reconciliation matrix: replace false "zero gaps" claim with open items 35-39 for rubric check alignment work Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
10 tasks: create principles doc, add framework cross-ref, fix 4 tool_name() calls, inline 7 opaque functions, unify 4 retired synonyms, update reconciliation matrix. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- codex: Task→subagent.dispatch, TodoWrite→task.track - gemini-cli: Task→subagent.dispatch - openclaw: Task→subagent.dispatch (2 instances) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
find_file→find_first, count→len in codex, cursor, gemini-cli, openclaw Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…trix All verification checks pass: zero stale tool_name() args, zero opaque functions, zero retired synonyms, pseudocode-principles doc created. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
directory_exists→dir_exists in manifest-generation.md count→len in injection-checks.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
9 hardcoded platform data instances across 5 pattern files to replace with REGISTRY lookups. 2 new reverse-lookup helpers for platform-api.md. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Include extra_events in Codex hook allowlist derivation - Add marketplace_path to PlatformSpec.manifest instead of supplementary list - Derive context_checks from both primary_file and secondary_files - Add GEMINI.md to Antigravity secondary_files as prerequisite Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
9 tasks: PlatformSpec prerequisites, 2 new API functions, 5 pattern file edits, verification + reconciliation matrix update. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- marketplace_path field in manifest type - platform_for_spec() and platform_for_hooks() for inventory lookups Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…secondary_files Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…okups Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…tion-checks Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Uplift Target Registry (3 entries) and Template Registry (10 entries) in lib/references/ with concept-aligned directories. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add missing Antigravity and OpenClaw template entries (10→12) - Add template_for_path() lookup matching rubric template contract - Add completeness verification checks Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
8 tasks: 2 registry files, 3 SKILL.md consumer edits, inventory sidecar strategy, manifest-generation table, reconciliation matrix. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- uplift-targets/registry.md: 3 entries, 2 lookup functions - templates/registry.md: 12 entries, 3 lookup functions Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Phase 0b: derive options from UPLIFT_TARGETS - Phase 5: ALLOWED_CATEGORIES → allowed_categories() - Phase 5: resolve_target_path → template_for_path().target_path - External references: add registry paths Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…on matrix Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Per-schema sections now document only rendering notes (conditional logic, field requirements). Target paths and template locations are looked up via template_for_schema() from the Template Registry. Added antigravity-package and openclaw-plugin sections for completeness. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Each per-schema section is now a GENERATE() function that: - Looks up paths via template_for_schema() from the Template Registry - Dispatches to the correct rendering mode (plain/conditional/builder) - Documents schema-specific logic as inline comments All rendering notes preserved: conditional key omission, Gemini optional fields, variable substitution, codex native-plugin-packaging gates, etc. Added antigravity-package and openclaw-plugin sections. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
platform-mappings.md+ 5*-tools.md) with a structured pseudocode libraryplatform-api.mddefinesPlatformSpectype system, canonicalOperation/CanonicalEventenums, and 11 deterministic lookup functionsplatforms/each declare a completePlatformSpecdictionarylib/patterns/subagent-dispatch.mdTest plan
grep -rn 'platform-mappings\|gemini-tools\.md\|codex-tools\.md' lib/ skills/ GEMINI.md AGENTS.md CLAUDE.md .github/ CONTRIBUTING.mdreturns no stale referenceslib/references/platforms/🤖 Generated with Claude Code