[docs] - README: document the PowerShell coding harness (harness/ + powershell/)#650
Merged
Merged
Conversation
…rshell/) README predated the harness merge (#635/#643 on 2026-07-22): the new out-of-band console package, its Windows installer, and its 127.0.0.1:8790 console were absent from What It Does, the TOC, and the Project Structure tree, while the existing "Agentic Harness Scaffold (v1.9)" section describes the older agentic/harness_optimizer scaffold — a different subsystem. Add a concise "PowerShell Coding Harness (v1.9)" section (launch, install, chat path over the OpenAI-compatible /v1 endpoint, reuse-not-duplication, I6 isolation) linking to docs/HARNESS_POWERSHELL.md as the authority, plus tree entries for harness/ and powershell/ and item 10 in What It Does. All numbers sourced from harness/config.py and pyproject.toml; doc-sync checker reports 0 drift after the change. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0138hmScu3tFU4v1jzvFUwVT
cgfixit
marked this pull request as ready for review
July 24, 2026 15:31
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
2 participants
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.
Proposed changes
Phase 1 doc-sync deliverable: the README predated the harness merge (#635/#643, 2026-07-22) — the new out-of-band
harness/console package, itspowershell/installer, and the127.0.0.1:8790console were absent from What It Does, the TOC, and the Project Structure tree. (The existing "Agentic Harness Scaffold (v1.9)" section covers the olderagentic/harness_optimizerscaffold — a different subsystem — so readers had no pointer to the actual console.)Adds, README-only (+42 lines, no deletions):
cyclaw-harness→127.0.0.1:8790, loopback-refuses-non-loopback), Windows install one-liner, chat over the OpenAI-compatible/v1endpoint fromconfig.yaml'smodels.local_llm.base_url, reuse-not-duplication (ops_runner shim, read-only registry views, ponytail+karpathy system prompt), and I6 isolation — linking todocs/HARNESS_POWERSHELL.mdas the authority rather than duplicating it.harness/andpowershell/entries in the Project Structure tree.Invariant / Governance Impact: None — documentation only.
doc-syncchecker: 0 drift after the change.Types of changes
Scope note: Docs only.
Benefits / why
8790fromharness/config.py(DEFAULT_PORT),cyclaw-harnessfrompyproject.toml[project.scripts], install path from the shippedpowershell/Install-CyClaw.ps1.Risks to monitor
config.yaml/harness/config.pyvalues, and thedoc-syncskill's manual pass covers README prose; keep the section pointed atdocs/HARNESS_POWERSHELL.mdfor details so drift surface stays small.Further comments
Verified:
python3 .claude/skills/doc-sync/doc_sync.py→ 0 drift items; TOC anchor matches the heading exactly once; pure-addition diff touches nothing else. Part of the Phase 1 optimize pass (Ollama/LM-Studio compat PRs to follow from the scan in progress).🤖 Generated with Claude Code
https://claude.ai/code/session_0138hmScu3tFU4v1jzvFUwVT
Generated by Claude Code