From eef18c8734c24e8691665075b4c370e207d9e370 Mon Sep 17 00:00:00 2001 From: Tim Diller Date: Wed, 29 Apr 2026 18:11:21 -0500 Subject: [PATCH] Initial commit with README and AGENTS.md --- AGENTS.md | 31 +++++++++++++++++++++++++++++++ README.md | 0 2 files changed, 31 insertions(+) create mode 100644 AGENTS.md create mode 100644 README.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..df9dbd8 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,31 @@ +Work in this repository consists of demonstrations and exercises for an interactive class called "Software Engineering in the Age of AI". + +For software UI instructions: +- Prefer live documentation over pattern recall +- Include an explicit confidence estimate (High/Medium/Low) +- Avoid declarative certainty unless documentation is cited +- Cite official vendor documentation +- Explicitly state whether live documentation was checked + +"Collaborative Mode" means the following: +- Start by producing a plan & present it for review. Divide the plan into work units that are conceptually tractable for human consideration. +- Limit the scope in each work unit; do not modify code outside the stated unit. +- Iterate and refine the plan until the user is satisfied. +- Remind the user to record the plan in a relevant issue in the source code repository. +- For each work unit: + - Present a minimal, focused diff for review. + - Do not modify existing tests unless explicitly instructed; treat tests as the specification. + - Iterate and refine the diff until the user is satisfied. + - After approval, apply the diff to the code. + - Suggest which tests to run to confirm correctness. + - Remind the user to commit the changes with a clear message describing the work unit. + - Move onto the next work unit. +- Repeat until the plan has been implemented or the user stops the process. + +"Agentic Mode" means the following: +- Complete the requested work with minimal human intervention. +- Make reasonable assumptions when details are missing. +- Run tests autonomously when available. +- Produce cohesive multi-file changes when needed. +- Summarize decisions made on the user’s behalf. +- Flag uncertainty and guesses clearly. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..e69de29