docs: guide a useful contribution with an AI agent #25

Merged

ClaudiuSchuster merged 4 commits from oss-oo/contributing-with-agent-guide-20261016 into main

2026-10-16 03:15:55 +00:00

ClaudiuSchuster commented

2026-10-16 01:17:07 +00:00

Owner

Problem and resulting behavior

New contributors need a practical way to turn an idea into a useful, reviewable contribution with an AI agent. This guide connects the existing project entry points to choosing a task, providing context, checking sources and handing off the result, with research, art and wording examples alongside software work.

The documentation also records a real fresh-agent continuation and updates project brief revision 3. The change is limited to four documentation files.

Verification

Repository baseline and site-boundary checks passed. A separate native AI reviewer accepted the complete change and both bounded corrections. Root checked the final documents, exact four-file scope, immutable source history and remote head 3fec7e031761fcacbccb15af508cd064120c8143 (tree a7ae002adf82c318c95a9e51465ba22bc189d330).

Scope and limitations

AI authorship and review are explicit; human usability testing remains open. The existing Workshop form's Atlas-category ambiguity remains a separate editorial follow-up.

Integration should retain the author and continuation commits through the permitted protected fast-forward path, so the continuation record's pinned source remains in main's history. This PR records the delegated maintainer integration decision; it does not constitute human usability testing.

## Problem and resulting behavior New contributors need a practical way to turn an idea into a useful, reviewable contribution with an AI agent. This guide connects the existing project entry points to choosing a task, providing context, checking sources and handing off the result, with research, art and wording examples alongside software work. The documentation also records a real fresh-agent continuation and updates project brief revision 3. The change is limited to four documentation files. ## Verification Repository baseline and site-boundary checks passed. A separate native AI reviewer accepted the complete change and both bounded corrections. Root checked the final documents, exact four-file scope, immutable source history and remote head `3fec7e031761fcacbccb15af508cd064120c8143` (tree `a7ae002adf82c318c95a9e51465ba22bc189d330`). ## Scope and limitations AI authorship and review are explicit; human usability testing remains open. The existing Workshop form's Atlas-category ambiguity remains a separate editorial follow-up. Integration should retain the author and continuation commits through the permitted protected fast-forward path, so the continuation record's pinned source remains in main's history. This PR records the delegated maintainer integration decision; it does not constitute human usability testing.

ClaudiuSchuster added 4 commits

2026-10-16 01:17:07 +00:00

docs: add contributing-with-an-agent guide and brief revision 3 8cec199913

docs: continue contributing-with-agent guide with a fresh pass 9c798142a3

docs: close owner review findings on the agent guide continuation 6bfe9853a8

docs: correct fetch protocol wording and date the brief review status

Repository checks / repository-baseline (pull_request) Successful in 24m24s

Details Explain this check

Repository checks / repository-baseline (push) Has been cancelled

Details Explain this check

3fec7e0317

ClaudiuSchuster referenced this pull request