Agent Working Rules - 修訂紀錄

Tommy：Remove Source section

2026-10-12T12:43:48Z

Remove Source section

←上個修訂		2026年10月12日 (一) 20:43的版本
第43行：		第43行：
	* Order: plot, then table, then text.		* Order: plot, then table, then text.
	* Spell out terms in full, with no abbreviations the agent made up.		* Spell out terms in full, with no abbreviations the agent made up.

	~~== Source ==~~
	~~Some rules are adapted from [[如何用正確的方法來寫出品質好的軟體的75條體會]] (items 9, 15, 16, 17, 20, 28, 33, 34, 44, 57, 58, 59, 60 and 67).~~

	[[Category:Software Engineering]]		[[Category:Software Engineering]]

Tommy：Add rules adapted from the 75 lessons page

2026-10-12T12:42:14Z

Add rules adapted from the 75 lessons page

←上個修訂		2026年10月12日 (一) 20:42的版本
第5行：		第5行：
	* Write summaries as a chain of the facts that decide the outcome.		* Write summaries as a chain of the facts that decide the outcome.
	* Give trade-offs only when asked.		* Give trade-offs only when asked.
			* Say why with every decision or change, in one line.
			* Before a large change, state the plan and get my agreement before writing code.

	== Hardware ==		== Hardware ==
第15行：		第17行：
	* Every push needs my OK.		* Every push needs my OK.
	* No branches the agent made itself, and no worktrees.		* No branches the agent made itself, and no worktrees.
			* Every commit message says what changed and why, and names the bug it fixes.

	== Code boundaries ==		== Code boundaries ==
	* Never edit shared upstream logic.		* Never edit shared upstream logic.
	* Fix at the config, port or override seam, and keep a drift record of the change.		* Fix at the config, port or override seam, and keep a drift record of the change.
			* Keep the change as small and simple as the problem allows; cut scope instead of adding it.
			* Reuse what the project, SDK or a library already provides before writing new code.
			* Fix known bugs in the area before adding new features to it.
			* Match the existing code: its style, naming, error handling and comment density.
			* Do not add input checks to internal calls or comments to every function.

			== Testing ==
			* Before handing work over, build it and run every test the agent can run without the device.
			* Finish the last 5%: check the whole path end to end, not only the part that changed.
			* A bug report gives exact steps to reproduce it, what was expected and what happened.
			* Only I close a bug or call it fixed, after I have tested it on the device.

	== Evidence ==		== Evidence ==
	* Never present a guess as a root cause.		* Never present a guess as a root cause.
	* Take values from documentation, <code>.config</code> or the device tree source (DTS), never by eye.		* Take values from documentation, <code>.config</code> or the device tree source (DTS), never by eye.
			* Never assume. When a fact is unknown, check it or ask; never start a sentence with "I assumed".

	== Documents ==		== Documents ==
第28行：		第43行：
	* Order: plot, then table, then text.		* Order: plot, then table, then text.
	* Spell out terms in full, with no abbreviations the agent made up.		* Spell out terms in full, with no abbreviations the agent made up.

			== Source ==
			Some rules are adapted from [[如何用正確的方法來寫出品質好的軟體的75條體會]] (items 9, 15, 16, 17, 20, 28, 33, 34, 44, 57, 58, 59, 60 and 67).

	[[Category:Software Engineering]]		[[Category:Software Engineering]]

Tommy：New page: Agent Working Rules

2026-10-12T12:38:56Z

New page: Agent Working Rules

新頁面

The '''Agent Working Rules''' (working agreement with the agent) are the house rules any AI assistant follows when working with me. They are rules about how to work, not facts about a project.

== Communication ==
* Answer in 1–2 lines, fact first.
* Write summaries as a chain of the facts that decide the outcome.
* Give trade-offs only when asked.

== Hardware ==
* Never flash, reset or touch the bench while I am testing.
* Ask first, every time.
* An imperative is an order to execute, not a topic to discuss.

== Git ==
* Every commit is tested on the device.
* Every push needs my OK.
* No branches the agent made itself, and no worktrees.

== Code boundaries ==
* Never edit shared upstream logic.
* Fix at the config, port or override seam, and keep a drift record of the change.

== Evidence ==
* Never present a guess as a root cause.
* Take values from documentation, <code>.config</code> or the device tree source (DTS), never by eye.

== Documents ==
* Write them as HTML.
* Order: plot, then table, then text.
* Spell out terms in full, with no abbreviations the agent made up.

[[Category:Software Engineering]]

Agent Working Rules - 修訂紀錄

Tommy：​Remove Source section

Tommy：​Add rules adapted from the 75 lessons page

Tommy：​New page: Agent Working Rules

Tommy：Remove Source section

Tommy：Add rules adapted from the 75 lessons page

Tommy：New page: Agent Working Rules