From 8c5d868fadb7d30dc31161905bea378746a97d7d Mon Sep 17 00:00:00 2001 From: Michal Dengusiak Date: Tue, 18 Aug 2026 10:07:28 +0200 Subject: [PATCH 1/2] Add AI agent instructions and project progress tracking Generated by Michal Dengusiak and CodeClaude Co-Authored-By: Claude Sonnet 5 --- AGENTS.md | 54 +++++++++++++++++++++++++++++++++++++++++++++ PROJECT_PROGRESS.md | 28 +++++++++++++++++++++++ 2 files changed, 82 insertions(+) create mode 100644 AGENTS.md create mode 100644 PROJECT_PROGRESS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..2dbb955 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,54 @@ +# Project Instructions + +This repository may be worked on by different AI agents, +models, sessions, accounts, and computers. + +Git and committed repository files are the authoritative project state. +Do not rely on previous conversation memory. + +## Before starting work + +Before making significant changes: + +1. Read this `AGENTS.md`. +2. Read `PROJECT_PROGRESS.md`. +3. Understand the relevant existing code, architecture, tests, and conventions. +4. Review the current Git branch and working tree. +5. Continue from the documented current state. + +Prefer small, safe, targeted changes consistent with existing conventions. +Avoid unrelated refactoring unless it is required for the task. + +## Project continuity + +After each meaningful implementation, debugging, research, +testing, or validation checkpoint, update `PROJECT_PROGRESS.md`. + +Do not update it for trivial actions such as opening files, +searching the repository, or reading documentation. + +Keep `PROJECT_PROGRESS.md` concise and sufficient for another AI +agent on another computer to continue without access to the current conversation. + +`PROJECT_PROGRESS.md` must contain: + +- current status; +- work completed; +- important decisions and assumptions; +- files changed; +- tests, builds, checks, or validation performed and results; +- unresolved issues, risks, or blockers; +- exact recommended next step. + +When updating `PROJECT_PROGRESS.md`, preserve still-relevant information +from previous sessions. Remove or replace information only when it is +obsolete, resolved, or superseded. + +Before ending meaningful work, verify that `PROJECT_PROGRESS.md` +accurately represents the current repository state. + +When appropriate, remind the user to commit and push changes before +switching computers, accounts, sessions, or AI agents. + +Never assume conversation history, terminal history, generated files, +or uncommitted local changes will exist on another computer. \ No newline at end of file diff --git a/PROJECT_PROGRESS.md b/PROJECT_PROGRESS.md new file mode 100644 index 0000000..496b4b8 --- /dev/null +++ b/PROJECT_PROGRESS.md @@ -0,0 +1,28 @@ +# Project Progress + +## Branch +`sow/2026-Q3` + +## Last updated +Not updated yet. + +## Current status +No work recorded yet for this branch. + +## Completed +- None yet. + +## Decisions / assumptions +- None yet. + +## Files changed +- None yet. + +## Validation +- Not run yet. + +## Issues / blockers +- None known. + +## Next step +- Review the current repository state and continue with the next planned task. \ No newline at end of file From 7a594251bdc0e92b12b663a099b8985b31cb92a5 Mon Sep 17 00:00:00 2001 From: Michal Dengusiak Date: Thu, 1 Oct 2026 16:48:27 +0200 Subject: [PATCH 2/2] chore: remove internal agent/progress files and evidence artifacts from upstream contribution Removes AGENTS.md, PROJECT_PROGRESS.md and internal evidence/.claude artefacts that are SAM-BIM workflow records, not upstream project documentation. Co-Authored-By: Claude Sonnet 5.5 --- AGENTS.md | 54 --------------------------------------------- PROJECT_PROGRESS.md | 28 ----------------------- 2 files changed, 82 deletions(-) delete mode 100644 AGENTS.md delete mode 100644 PROJECT_PROGRESS.md diff --git a/AGENTS.md b/AGENTS.md deleted file mode 100644 index 2dbb955..0000000 --- a/AGENTS.md +++ /dev/null @@ -1,54 +0,0 @@ -# Project Instructions - -This repository may be worked on by different AI agents, -models, sessions, accounts, and computers. - -Git and committed repository files are the authoritative project state. -Do not rely on previous conversation memory. - -## Before starting work - -Before making significant changes: - -1. Read this `AGENTS.md`. -2. Read `PROJECT_PROGRESS.md`. -3. Understand the relevant existing code, architecture, tests, and conventions. -4. Review the current Git branch and working tree. -5. Continue from the documented current state. - -Prefer small, safe, targeted changes consistent with existing conventions. -Avoid unrelated refactoring unless it is required for the task. - -## Project continuity - -After each meaningful implementation, debugging, research, -testing, or validation checkpoint, update `PROJECT_PROGRESS.md`. - -Do not update it for trivial actions such as opening files, -searching the repository, or reading documentation. - -Keep `PROJECT_PROGRESS.md` concise and sufficient for another AI -agent on another computer to continue without access to the current conversation. - -`PROJECT_PROGRESS.md` must contain: - -- current status; -- work completed; -- important decisions and assumptions; -- files changed; -- tests, builds, checks, or validation performed and results; -- unresolved issues, risks, or blockers; -- exact recommended next step. - -When updating `PROJECT_PROGRESS.md`, preserve still-relevant information -from previous sessions. Remove or replace information only when it is -obsolete, resolved, or superseded. - -Before ending meaningful work, verify that `PROJECT_PROGRESS.md` -accurately represents the current repository state. - -When appropriate, remind the user to commit and push changes before -switching computers, accounts, sessions, or AI agents. - -Never assume conversation history, terminal history, generated files, -or uncommitted local changes will exist on another computer. \ No newline at end of file diff --git a/PROJECT_PROGRESS.md b/PROJECT_PROGRESS.md deleted file mode 100644 index 496b4b8..0000000 --- a/PROJECT_PROGRESS.md +++ /dev/null @@ -1,28 +0,0 @@ -# Project Progress - -## Branch -`sow/2026-Q3` - -## Last updated -Not updated yet. - -## Current status -No work recorded yet for this branch. - -## Completed -- None yet. - -## Decisions / assumptions -- None yet. - -## Files changed -- None yet. - -## Validation -- Not run yet. - -## Issues / blockers -- None known. - -## Next step -- Review the current repository state and continue with the next planned task. \ No newline at end of file