Skip to content

Point the workshop notes at the app's AGENTS.md - #90

Merged
raghubetina merged 1 commit into
mainfrom
agent-guidance-pointer
Oct 12, 2026
Merged

raghubetina merged 1 commit into
mainfrom
agent-guidance-pointer

Conversation

@raghubetina

Copy link
Copy Markdown
Contributor

The Setup and specs bullet in .devcontainer/workshop/app-instructions.md copied the generated AGENTS.md's spec rule and needed a mirror PR each time the Compiler added a kind of stub. On 2026-10-12 the owner made the app's AGENTS.md the one copy and changed the rule: the agent writes any Behavior to write item that makes Home raise, previews without asking, and debugs other failures instead of handing them to the user. The service side is firstdraft/firstdraft#1149.

  • Setup and specs: set up, build, run the specs as the README says; the app's AGENTS.md says how to treat the results and when to preview. The Selenium steps stay.
  • Web app: starts "to start the preview" instead of "once the specs have run".
  • AGENTS.md, Blocked hosts: add the exact forwarded host to development's config.hosts, note it under First Draft defects in .firstdraft/design/implementation-notes.md, and continue (still never clear config.hosts), instead of stopping the workshop.
  • AGENTS.md, root Compile: no separate approval of moving the Drawing Board into .firstdraft/design/; the Skill's read-back decides when Compile runs.
  • README step 7: drops the sentence about Claude asking how involved you want to be in technical decisions, which the next Skill stops doing; the rest of the step holds before and after that release.

Timing: until the service deploys #1149, a generated AGENTS.md still carries the old rule, and the pinned 0.8.15 Skill still asks before previewing. The pointer is correct on both sides.

Not run: a Codespace, or an agent reading the notes. No review, per the risk tiers for mirror text.

Docs: updated .devcontainer/workshop/app-instructions.md, AGENTS.md, and README.md step 7.

The Setup and specs bullet copied the generated AGENTS.md's spec rule
and needed a mirror change each time the Compiler added a kind of
stub. On 2026-10-12 the owner made the app's AGENTS.md the one copy
and changed the rule: the agent previews before every Behavior to
write item is written and debugs other failures instead of reporting
them. The bullet now runs setup and the specs and points to that
file. The Selenium steps stay because they belong to this Codespace.

The Blocked hosts rule stopped the workshop. The agent now adds the
exact forwarded host to development's config.hosts, notes it under
First Draft defects in the implementation notes, and continues, still
without clearing config.hosts. Root Compile no longer asks for a
separate approval to move the Drawing Board into .firstdraft/design/,
which is the designed workshop path; the Skill's read-back decides
when Compile runs.

README step 7 no longer says Claude asks how involved you want to be
in technical decisions, which the next Skill stops doing. The rest of
the step holds before and after that release.
@raghubetina
raghubetina merged commit fae4584 into main Oct 12, 2026
1 check passed
@raghubetina
raghubetina deleted the agent-guidance-pointer branch October 12, 2026 17:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant