Skip to content

docs: strengthen portfolio proof and messaging#6

Merged
OgeonX-Ai merged 9 commits into
mainfrom
docs/portfolio-hardening-20260610
Jun 11, 2026
Merged

docs: strengthen portfolio proof and messaging#6
OgeonX-Ai merged 9 commits into
mainfrom
docs/portfolio-hardening-20260610

Conversation

@OgeonX-Ai

Copy link
Copy Markdown
Contributor

Summary

  • strengthen the top-level README messaging for portfolio presentation
  • add supporting proof-point documentation to make the repo narrative clearer
  • tighten the documentation story so the project is easier to evaluate as portfolio work

Why

These changes harden portfolio positioning and documentation clarity for the orchestrator repo.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a65f773c8d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/proof-points.md
| Issue workflow mode via `--issue <number>` | `src/GsdOrchestrator/Program.cs` |
| Triage-only mode via `--issue <number> --triage` | `src/GsdOrchestrator/Program.cs`, `src/GsdOrchestrator.Tests/TriagingStateTests.cs` |
| PR review mode via `--pr <number>` | `src/GsdOrchestrator/Program.cs`, `src/GsdOrchestrator.Tests/ReviewingStateTests.cs` |
| Watch mode across configured repos via `--watch` | `src/GsdOrchestrator/Program.cs`, `src/GsdOrchestrator/Workflows/Models/RepoConfigLoader.cs` |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct the multi-repository watch-mode claim

When GSD_REPOS contains multiple repositories, --watch does not watch across them: Program.cs awaits the indefinitely running RunWatchModeAsync inside the foreach loop, so only the first configured repository is ever polled. Describing this as watch mode "across configured repos" gives users an incorrect expectation and can leave later repositories silently unprocessed.

Useful? React with 👍 / 👎.

Comment thread README.md
## Enterprise Proof Points

- **Durability**: workflow state is checkpointed so interrupted runs can be resumed.
- **Guardrails**: validation blocks unsafe diffs, merge-conflict surprises, and weak test intent.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Avoid claiming that weak test intent blocks validation

For plans requiring tests with no modified or generated test files, ValidatingState records only a Warn result and then transitions to Committing; structurally invalid generated tests are also warnings. Therefore the new claim that validation "blocks ... weak test intent" overstates the implemented guardrail and could cause operators to rely on a safety behavior that is not enforced.

Useful? React with 👍 / 👎.

@OgeonX-Ai OgeonX-Ai merged commit 29d2989 into main Jun 11, 2026
1 check passed
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.

2 participants