feat(browser): surface sitemap context#1820
Merged
Merged
Conversation
2 tasks
jackwener
added a commit
that referenced
this pull request
Jun 1, 2026
* docs(sitemap-author): add detailed schema reference Companion to #1820 — extends the inline schema in SKILL.md with the field-level spec promised in the design thread: - File schemas: SITE.md / pages/<id>.md / workflows/<id>.md / apis.md / pitfalls.md with frontmatter fields and required sections. - Action schema with all 6 required fields (preconditions, postconditions, failure_signals, recovery, evidence, plus optional action-level state_signature for multi-step internal re-entry). - Workflow adapter_health enum (healthy / suspect / broken) backing the Best path / Fallback path routing rule. - apis.md endpoint reference format that points at endpoints.json by id instead of duplicating endpoint detail (avoids double-stale). - Two-layer overlay semantics (local wins, stable-id matching, draft placement inside sitemap/ to remain discoverable, optional site-alias.json for sitemap-without-adapter cases). - Phase 2 validation rules: file size budget, cross-ref integrity, reality check via opencli browser, forbidden-content scan. - Cross-links to strategy-selection.md (contract_strength / auth_strategy enums) and api-discovery.md. SKILL.md gets a pointer to the new reference plus a draft-placement red line so authors don't drop drafts at the parent dir where the browser availability detection cannot see them. * docs(sitemap): seed authoring from adapter traces
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
Verification