Skip to content

docs(workflow): learnings from the docs-sync repro gate - #4829

Open
iscekic wants to merge 2 commits into
mainfrom
docs-sync-cli-47f4
Open

docs(workflow): learnings from the docs-sync repro gate#4829
iscekic wants to merge 2 commits into
mainfrom
docs-sync-cli-47f4

Conversation

@iscekic

@iscekic iscekic commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Two workflow learnings recorded by the docs-sync CLI section's repro gate, committed so future
workflow runs inherit them (.kilo_workflow/learnings/ is the workflow's shared memory — see
.kilo_workflow/WORKFLOW.md):

  • docs-sync-repro-round-state-reset.md — an edit.mjs repro round must reset state between
    runs: it short-circuits on leftover docs-sync-out/ summaries and a pre-dirty
    packages/kilo-docs, silently faking "work done".
  • background-process-inline-quote-mangling.mdbackground_process mangles inline
    ruby/perl one-liners in the command string; write a runner script file and invoke that instead.

Docs-only, exactly these two files, nothing else. Companion (code) PR:
Kilo-Org/kilocode#12605 — the docs-sync bot fix these learnings came from.

Verification

  • No manual testing — documentation-only change under .kilo_workflow/learnings/, no code paths
    touched. Content was validated during the docs-sync repro gate itself (both entries record
    blockers that were hit and resolved there).

Visual Changes

N/A

Reviewer Notes

Cross-link: Kilo-Org/kilocode#12605

- docs-sync edit-pass repro rounds need state reset between runs
  (edit.mjs short-circuits on leftover summaries)
- background_process mangles inline ruby/perl one-liners; use a
  runner script file instead
@iscekic iscekic self-assigned this Jul 28, 2026
@kilo-code-bot

kilo-code-bot Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Executive Summary

Reviewed two new workflow-learnings markdown files with no code, images, or logic changes; no issues identified.

Files Reviewed (2 files)
  • .kilo_workflow/learnings/background-process-inline-quote-mangling.md
  • .kilo_workflow/learnings/docs-sync-repro-round-state-reset.md

Reviewed by claude-sonnet-5 · Input: 12 · Output: 1.5K · Cached: 196.2K

Review guidance: REVIEW.md from base branch main

@iscekic

iscekic commented Jul 28, 2026

Copy link
Copy Markdown
Contributor Author

(bot) @kilocode-bot please review the latest head (7d6c470). The diff against main is unchanged (still the two learnings files); the branch was merged up with origin/main only.

@kilo-code-bot

kilo-code-bot Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Re-reviewed at 7d6c470 — since the diff against main is unchanged (still just the two learnings files, only a merge-up with origin/main), the prior review stands: no issues found, docs-only change, safe to merge.

@iscekic iscekic added the human-ready The PR is ready for human review. label Jul 28, 2026
@iscekic
iscekic requested a review from pandemicsyn July 29, 2026 00:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

human-ready The PR is ready for human review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant