Living-document agent + Windsurf/Cline docs skill — Suren Kotian - #6
Open
surenkotian wants to merge 2 commits into
Open
Living-document agent + Windsurf/Cline docs skill — Suren Kotian#6surenkotian wants to merge 2 commits into
surenkotian wants to merge 2 commits into
Conversation
… API Agent owns "[AGENT-MAINTAINED] Live Service Status" in a standing document, regenerating it from a changing external source while never touching the human-written sections around it. Every claim is proven against a real SuperDocs account (self-signup, free tier), not mocked: a real bootstrap, two real update cycles with byte-for-byte boundary verification, a proven zero-op stopping rule (checked via whoami before and after), and a genuinely no-spend preview mode. Includes a real bug found and fixed while building: the first live update inserted a duplicate, un-addressable paragraph instead of replacing the existing one in place, because "the table and the Last-synced line" was two things to keep in sync instead of one. Fixed by folding the timestamp into the table as its own row. Full transcript in PROOF_RUN.md, honest account of what happened in README.md.
Teaches both hosts to route .docx/.pdf/.html edits through SuperDocs MCP tools before touching the file directly -- each half written natively for its own host (Windsurf: YAML-frontmatter workspace rule + mcp_config.json; Cline: plain-markdown .clinerules/ + its own cline_mcp_settings.json), not a shared shim. Verified against real, current documentation rather than memory: a real JSON-RPC initialize handshake against the live SuperDocs MCP server (mcp_handshake_proof.json), a real Cline VS Code extension install check, and a safe merge-installer whose logic is tested against real MCP client config files (never the live global paths directly, since those are real system state on the developer's machine). Two real, reportable findings along the way: Windsurf's own docs domain now redirects to docs.devin.ai (Cognition appears to have absorbed Windsurf since this brief was written) -- .windsurf/rules/ is confirmed still live as the documented legacy path. Separately, the MCP server's own initialize response advertises a skill guide at skill.mdx, which 404s; the real path is skill.md.
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.
Task 2 submission for the SuperDocs Founding Engineer round. Full details in each build's own README.