Skip to content

refactor: overhaul skill discovery and authorized workflows - #90

Open
parsakhaz wants to merge 2 commits into
mainfrom
codex/streamline-agent-workflows
Open

refactor: overhaul skill discovery and authorized workflows#90
parsakhaz wants to merge 2 commits into
mainfrom
codex/streamline-agent-workflows

Conversation

@parsakhaz

@parsakhaz parsakhaz commented Sep 6, 2026

Copy link
Copy Markdown
Member

The active workflows accumulated broad skill triggers, large always-loaded instructions, repeated validation recipes, and handoff gates that could stop an already-authorized implementation before its PR. This applies the principles in Eric Provencher's article across the active Parsa skill set.

What changes

  • Shorten discovery descriptions and distinguish draft rewriting, sentence editing, substantial content creation, read-only work questions, and active orchestration.
  • Route QA, diagrams, GTM planning, and RunPane operations to task-specific references. Preserve publishing, cleanup, head identity, and external-action contracts.
  • Make simple-plan, create-plan, implement, and prepare-pr continue through the user's authorized outcome while retaining planning-only and explicit review pauses.
  • Replace hardcoded Doozy/npm commands and mandatory repeat passes with repository-derived validation. Generate migrations before dependent checks and review.
  • Restore the full conjunctive PR-readiness gate to the Claude RunPane adapter, matching Codex.
  • Update skillify, repository instructions, and the README so newly authored skills follow the same approach.

The frozen tyler ancestor is untouched. Existing model/tool metadata and explicit invocation policies are retained, except simple-plan's read-only tool shortcut, which did not cover its implementation stage. Merge, release, deployment, production mutation, and release-asset publishing still need their matching authorization.

Documentation and diagrams

  • Replace the legacy-installer recommendation with Orchestra plus the Parsa overlay, and align software, business, SEO, and diagram READMEs with the current skill names and loading contracts.
  • Refresh the workflow map, skill legend, SEO map, and shared software-factory story. Regenerate all six PNGs from their editable sources.
  • Clearly label the frozen Tyler map and early Orchestra sketch as historical, and remove the historical map from the current workflow introduction. The visual index identifies current and archived material and documents regeneration.
  • Follow-up validation: 29 relative Markdown links checked; all six sources parsed and all six exported PNGs inspected. The shared story source and PNG match Orchestra byte for byte.

Rendering used Excalidraw 0.18's SVG exporter with bundled fonts and native SVG rasterization because local Chromium could not launch. No renderer or dependency changes are included.

Validation

  • Parsed changed skill/agent frontmatter and checked local Markdown/reference paths.
  • Verified identical rewrite-simply variants and no changes to tyler.
  • Exercised Orchestra plus Parsa installation in disposable directories: routed references, collision prefixes, reviewer rewrites, personal-file preservation, and repeat idempotence passed.
  • Independent local simple-plan exercise fixed a pagination fixture without re-requesting approval; all five behavior tests passed.
  • Independent readiness exercise correctly refused readiness with pending CI and an unpublished required visual, preserving separate upload and merge grants.
  • Final diff/whitespace and credential-pattern checks passed.

This validates representative behavior and installation contracts. It does not claim a live multi-issue Pane run or production QA.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 6, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-06T06:34:53.605454Z ece36a6 PR opened
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@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: ece36a64c5

ℹ️ 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 on lines +32 to +37
Use the repository's documented validation commands for the affected behavior.
Inspect current-head evidence already supplied by the implementation owner;
rerun when independent proof is required, inputs changed, or the result does
not resolve a review concern. Do not substitute hardcoded npm commands, require
irrelevant builds, or rerun a clean suite solely because a new review began.
Report the command, result, and evidence source; distinguish unavailable checks

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Update the stale implementation-review gate contract

When this reviewer runs in a repository whose gates are not TypeScript lint/typecheck, the new repository-derived policy conflicts with the unchanged output and rules below: lines 82-84 still require typecheck and lint, and line 149 explicitly requires running both. The Codex mirror retains the same conflict at lines 81-83 and 123, so either reviewer can invent irrelevant commands or misreport the checks that actually ran. Update the downstream report fields and rules to enumerate the discovered checks.

AGENTS.md reference: AGENTS.md:L27-L28

Useful? React with 👍 / 👎.

Comment on lines +41 to +45
Discover the repository's validation commands and inspect available evidence
for the reviewed head. Run checks that resolve a concrete correctness concern
or required gate; rerun after relevant changes. Reuse current passing results
otherwise. Record failures and unavailable checks without assuming a particular
package manager, application layout, or language.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Make the PR review report reflect discovered gates

For a non-Node review target, this now correctly discovers repository-specific validation such as go test or pytest, but the required review body at lines 104-106 still exposes only Typecheck and Lint. The posted review will therefore omit the checks that ran or present irrelevant fixed fields as its quality-gate evidence; make those rows dynamic or otherwise align the output contract with this generic gate policy.

AGENTS.md reference: AGENTS.md:L27-L28

Useful? React with 👍 / 👎.


## Render & Validate (MANDATORY)

You cannot judge a diagram from JSON alone. After generating or editing the Excalidraw JSON, you MUST render it to PNG, view the image, and fix what you see — in a loop until it's right. This is a core part of the workflow, not a final check.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Remove em dashes from the new instruction references

This newly added Codex instruction uses an em dash despite the repository-wide authoring rule, and the same character recurs throughout the added Codex diagram, QA, and RunPane reference files. These files are installed as active instructions, so replace the em dashes in the new instructional prose rather than shipping guidance that violates its own authoring contract.

AGENTS.md reference: AGENTS.md:L29-L29

Useful? React with 👍 / 👎.

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.

1 participant