Skip to content

Python rulebook - #7

Open
jasonbrazeal wants to merge 14 commits into
cppalliance:masterfrom
jasonbrazeal:python-rulebook
Open

Python rulebook#7
jasonbrazeal wants to merge 14 commits into
cppalliance:masterfrom
jasonbrazeal:python-rulebook

Conversation

@jasonbrazeal

Copy link
Copy Markdown

In addition to the rulebook, there are 2 intermediate docs in chats/, a research brief and a plan. I iterated on the plan quite a bit but regenerated the rulebook from it fresh each time.

I used the prompt rulebook extensively but there are a few things that I am pushing back on:

  1. Reserve NEVER, ALWAYS, and MUST for invariants... and cap them at three per target
    [Great advice in general, but these are very natural for a rulebook and will appear many times]

  2. Binding meta-rule: consistency within an existing project outranks every style rule in this rulebook
    [Good idea for most prompts, but the rulebook addresses this differently, being a set of rules itself]

  3. Strip provenance from every emitted artifact: state the rule, name no source document for it.
    [Sources for programming language rulebooks are a handful of websites (language documentation, library documentation, standards, etc.). The rulebook is supposed to distill all of that into a compact format, so of course agents reading it will need to look up finer points. I want to direct them to the canonical sources instead of having them search randomly.]

Also I found that it would copy the existing rulebook WAY too much, like word for word in some sections, even without me asking it to read those files. I deleted them all while I was working on this to prevent that.

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