V0.11.0/chore and git remote pr

[gimlichael]

This pull request introduces the deterministic git-remote-pr skill for creating and refreshing GitHub pull requests from committed changesets, establishes repository standards for scratch isolation, prose formatting, and PR routing, refactors agent-smith around an operating model framework, and adds visual identification assets across the skill catalog.

New git-remote-pr skill:

• Creates or updates one PR from the full committed branch comparison using read-only evidence collection, theme coverage checks, and body structure validation before any remote write.
• Requires explicit approval before push or metadata writes; same-request yolo/auto proceeds after showing the same preview.
• Blocks on dirty worktrees, missing or mismatched upstream tracking, and diverged remote heads; verifies title, body, draft state, assignee, and file inventory after execution.
• Ships prepare, plan, and execute helpers with regression coverage for CREATE/UPDATE distinction, approval integrity, and malformed-body rejection.

Repository standards:

• Adds PR Skill Routing, Working-tree Scratch Isolation, and Markdown Prose Formatting guidance to repository and skill documentation.
• Aligns commit, release, and squash-summary skills so temporary artifacts stay outside the working tree and prose stays on continuous physical lines.
• Documents the new workflow, standards, and v0.11.0 changelog entries for reviewers and skill authors.

Agent-smith operating model:

• Restructures the skill around a four-level decision framework with local repository policy replacing repository-family conventions.
• Adds durable software and agentic automation reference guides; refreshes core principles, delivery, API, and skill-authoring guidance.
• Updates evaluation definitions to match the operating model and precedence rules.

Documentation consistency:

• Applies continuous-line prose formatting and description refinements across the skill portfolio, scaffold templates, and NuGet references.
• Clarifies trigger-oriented skill descriptions and hard-wrap expectations without changing scaffold behavior.

Validation coverage:

• Extends template validation for agent-smith policy checks, markdown formatting assertions, and git-remote-pr integration.
• Adds agent-smith validation and historical regression isolation suites under temporary workspaces.

Visual skill identification:

• Adds hero images for eight skills to support catalog rendering and visual identification.

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge; no outstanding previous findings or actionable new defects remain.

Summary

This PR introduces the deterministic git-remote-pr workflow, expands repository guidance for PR routing, scratch isolation, and Markdown formatting, restructures agent-smith around a four-level operating model, and updates validation, evaluation, documentation, and visual assets across the skill catalog. The changes since the previous review replace a source-text assertion with a behavioral regression that injects a late cleanup failure and verifies that completed remote writes remain accurately reported.

• Adds prepare, plan, execute, approval-integrity, and post-write verification tooling for GitHub pull requests.
• Enforces exact upstream branch matching, complete committed-change coverage, and explicit approval boundaries.
• Adds deterministic validation and regression suites for git-remote-pr and agent-smith.
• Updates repository and skill documentation to use continuous-line Markdown prose and isolated scratch workspaces.
• Adds hero images and catalog metadata for multiple skills.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Committed base-to-head changeset] --> B[Prepare deterministic evidence]
  B --> C[Generate title, body, and plan]
  C --> D[Render approval-bound preview]
  D --> E{Approved and state unchanged?}
  E -->|No| F[Invalidate transaction]
  E -->|Yes| G[Push branch if required]
  G --> H[Create or update pull request]
  H --> I[Verify metadata, head SHA, and files]
  I --> J[Report final or partial remote state]

Loading

_{Reviews (10) · Last reviewed commit: "🔒️ add late cleanup failure injection t..."}