Conversation
added 2 commits
August 24, 2026 22:20
A script-style Python repo (venv, requirements.txt, tests/test_*.py, an app.py, no pyproject.toml) came out of /flow:init with every *_cmd blank, and the closing line told the *user* to go and edit .flow/config.md. /flow:health repeated it. Every one of those commands was discoverable from the repo in under a minute — that is the agent's work, not homework to hand back. init.js now: - detects from requirements*.txt (pytest, ruff, flake8, mypy, black), Makefile targets, and manage.py, none of which needed a manifest; - prefers the project's own venv copy of a tool (.venv/bin/pytest) over a bare name resolved against the ambient PATH; - ends by naming the keys still blank — reading the existing config.md, so a re-run reports the real state — addressed to the agent, with the instruction to infer, verify by running, and write them in. /flow:init grows a Step 3 that does exactly that, /flow:health fills a blank *_cmd instead of reporting it back, and the procedure (evidence sources per key, how to verify each without leaving a dev server running) lives in references/stack-command-inference.md.
…ands
An unsubstituted `{COMMAND_TO_START_DEV_SERVER}` left in config.md read
back as a filled-in command, so a re-run reported the key as done and the
agent never inferred it. Values matching `{ALL_CAPS}` now read as blank,
exactly like an empty value.
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
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.
Closes flykit-cc/flow#3
The problem
In a script-style Python repo — venv,
requirements.txt,tests/test_*.py, anapp.py, nopyproject.toml—/flow:initdetected nothing, left every*_cmdblank, and signed off with:/flow:healthreported the same blanks the same way. Every one of those commands was discoverable from the repo in under a minute, so this was homework handed back to the user for a step the agent can finish in one pass.What changed
scripts/init.jsrequirements*.txtdependencies (pytest, ruff, flake8, mypy, black),Makefiletargets, andmanage.py. A manifest command still wins over theMakefilewrapper around it..venv/bin/pytest, not a barepytestresolved against whatever is onPATH.config.md, so a re-run against an already-initialised project reports its real state rather than a fresh detection. The wording is addressed to the agent: infer each one, verify it runs, write it in. The "edit config.md yourself" line is gone.commands/init.md— new Step 3, "Fill in what detection missed": work each blank key out from the repo, verify by running it, write it withEdit. Steps renumbered;Edit/Glob/Grepadded toallowed-tools.commands/health.md— a blank*_cmdis now filled in and reported asFIXED, not read back to the user. Health stays diagnostic in every other respect, and the doc says so.references/stack-command-inference.md(new) — the shared procedure both commands follow: where the evidence for each key lives, preferring the project's environment, how to verify each command without leaving a dev server running, and when a blank is a real decision.Docs (
README.md,SETUP.md,references/config-template.md) no longer tell users to fill blanks in by hand.Version bumped 0.6.0 -> 0.7.0 across
plugin.json,package.json, andmarketplace.json.Testing
15 new tests cover the requirements/venv/Makefile/
manage.pydetection,readStackCommands/missingStackCommands, and the closing report — including an assertion that the output never tells the user to edit.flow/config.md.End-to-end on the repro shape (venv +
requirements.txtwith pytest +tests/test_app.py+app.py, nopyproject.toml):