V0.10.2/service update

[gimlichael]

Introduce git-remote-pr skill and establish repository standards for working-tree scratch isolation, markdown prose formatting, and deterministic PR workflows. This release includes a complete skill for managing GitHub pull requests from committed branches with evidence-based PR bodies, safe remote operations, and post-write verification.

New git-remote-pr Skill and Implementation

The git-remote-pr skill provides deterministic GitHub PR creation and updates from complete committed changesets. The skill documentation (Git-remote-pr skill documentation) explains the workflow, approval boundaries, and interaction with other Git tools. Five bundled helper scripts drive the workflow: PR preparation helper (prepare-pr.ps1) collects evidence about the branch, merge base, repository state, and remote configuration; PR plan generation (make-plan.ps1) generates a PR plan with title and body; PR creation and update execution (execute-pr.ps1) creates or updates the PR with safe push handling and post-write verification; shared PR utility functions (pr-common.ps1) provide reusable helpers. The skill requires explicit approval before any remote writes in normal mode, and both modes show an identical preview. Read-only preparation collects facts through Git and gh CLI; the agent writes body prose from evidence. Git-remote-pr evaluation cases (evals.json) and a comprehensive PR skill regression tests (test-pr.ps1) suite verify correct behavior across scenarios.

Repository guidance updates: PR routing, scratch isolation, markdown formatting

Repository guidance updates (AGENTS.md) introduce three core standards: PR skill routing documents when git-remote-pr is invoked and its approval boundary; working-tree scratch isolation requires temporary artifacts (API responses, investigation notes, intermediate files, eval fixtures) to stay in .bot/<task>-workspace/ (default inside the repository) or operating-system temp directories, forbidding git repos and temporary commits from the working tree; markdown prose formatting requires prose paragraphs and list items on continuous physical lines without arbitrary hard wrapping, with line breaks only at structural boundaries (paragraphs, headings, code blocks, tables). These standards prevent repository pollution, improve readability, and create cleaner diffs.

Documentation and skill catalog updates

Release notes for v0.11.0 (CHANGELOG.md) document the release with all changes and impacts. Documentation and skill catalog updates (README.md) include git-remote-pr skill entry, markdown formatting guidance for skill authors, and additional community health sections explaining repository standards. Skill descriptions across the portfolio are refined to emphasize operating model and trigger precision.

Agent-smith Restructuring and References

The agent-smith skill is restructured with an operating model framework (Agent-smith restructuring with operating model framework) emphasizing durable software and agentic engineering decision orientation. New reference guides introduce New agentic engineering reference guide (agentic-engineering.md) documenting patterns and principles for autonomous agent systems, and New automation reference guide (automation.md) covering automation boundaries, safety, and governance. Existing references are all updated: API design reference updates (api-design-and-compatibility.md), Architecture reference updates (architecture.md), Assessment template updates (engineering-assessment-template.md), Agent handoff template updates (agent-handoff-template.md), Core principles reference updates (core-principles.md), Decision framework reference updates (decision-framework.md), Delivery reference updates (delivery-and-repositories.md), Documentation reference updates (documentation.md), .NET reference updates (dotnet.md), Governance reference updates (governance.md), Performance reference updates (performance.md), Response contract reference updates (response-contract.md), Security reference updates (security-and-devsecops.md), Skill authoring reference updates (skill-authoring.md), and Testing reference updates (testing.md). Agent-smith evaluation updates (evals.json) reflect the new structure. An agent-smith validation test suite (scripts/tests/test-agent-smith.ps1) asserts conformance, guidance coverage, and reference completeness. Agent-smith visual hero image (assets/hero.jpg) supports documentation rendering.

Markdown Formatting and Visual Assets

Markdown formatting standards applied consistently across 12 skills: agent-smith (SKILL.md), dotnet-benchmark, dotnet-change-impact, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, dotnet-strong-name-signing, dotnet-test, git-keep-a-changelog, git-nuget-readme, git-nuget-release-notes, git-remote-release, git-repo-digest, git-visual-commits, git-visual-squash-summary, markdown-illustrator, and trunk-first-repo. Updates include SKILL.md files and reference documents. Markdown formatting standards applied to scaffold templates (shared/AGENTS.md files) in dotnet-new-app-slnx and dotnet-new-lib-slnx. Evaluation updates with markdown formatting applied to evals.json across skills. Skill hero image assets (dotnet-benchmark, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, dotnet-test) support skill identification and documentation rendering.

Validation Infrastructure

Validation infrastructure for new standards (scripts/validate-skill-templates.ps1) is enhanced with assertions for git-remote-pr integration, markdown formatting standards, working-tree scratch isolation across affected skills, and agent-smith guidance coverage. Agent-smith validation test suite (scripts/tests/test-agent-smith.ps1) asserts conformance, guidance coverage, and reference completeness. All validators remain model-free and run deterministically as local completion gates. Repository updates and maintenance across scripts and configuration files support the new standards and skill infrastructure.

Changes Summary

This comprehensive update spans: .NET reference updates, Agent handoff template updates, Agent-smith evaluation updates, Agent-smith restructuring with operating model framework, Agent-smith visual hero image, API design reference updates, Architecture reference updates, Assessment template updates, Core principles reference updates, Decision framework reference updates, Delivery reference updates, Evaluation updates with markdown formatting, Git-remote-pr evaluation cases, Git-remote-pr skill documentation, Governance reference updates, Markdown formatting standards applied, Markdown formatting standards applied to scaffold templates, New agentic engineering reference guide, New automation reference guide, Performance reference updates, PR creation and update execution, PR plan generation, PR preparation helper, PR skill regression tests, Release notes for v0.11.0, Repository guidance updates: PR routing, scratch isolation, markdown formatting, Repository updates and maintenance, Response contract reference updates, Security reference updates, Shared PR utility functions, Skill authoring reference updates, Skill hero image asset, and Testing reference updates.

[gimlichael]

Closed: PR created with incorrect branch name. Correct branch is v0.11.0/chore-and-git-remote-pr, not v0.10.2/service-update. Creating new PR with correct branch.

[greptile-apps]

Confidence Score: 4/5

The PR appears safe to merge after correcting the non-blocking hero-image inventory in the release notes.

Findings

1.  Hero image inventory is inaccurate ▶

Fix with agent prompt

### Issue 1
CHANGELOG.md:25
This entry says eight hero images were added but names nine skills, including `git-remote-pr`, which has no hero image in this changeset. This makes the published release inventory inaccurate; either remove `git-remote-pr` from the list or add its missing asset.

```suggestion
- Hero images (`.jpg`) for eight skills providing visual identification and documentation rendering support: agent-smith, dotnet-benchmark, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, and dotnet-test,
```

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

This PR introduces the git-remote-pr skill and its deterministic preparation, planning, execution, verification, and regression-test workflow. It also restructures agent-smith, adds engineering and automation references, expands repository validation, standardizes Markdown prose guidance, and refreshes documentation and visual assets.

• Adds approval-bound GitHub PR creation and refresh automation with full changeset evidence.
• Adds focused regression and repository-validation coverage.
• Expands agentic-engineering, automation, and repository-authoring guidance.
• Applies Markdown formatting and visual-asset updates across the skill catalog.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Explicit PR request] --> B[prepare-pr.ps1]
  B --> C[Evidence, patch, template]
  C --> D[Agent authors body and themes]
  D --> E[make-plan.ps1]
  E --> F[Mutation preview]
  F -->|Normal approval or scoped auto| G[execute-pr.ps1]
  G --> H[Recheck approved snapshot]
  H --> I[Optional normal push]
  I --> J[Create or update PR]
  J --> K[Assign authenticated user]
  K --> L[Verify metadata, SHA, and file inventory]

Loading

_{Reviews (1) · Last reviewed commit: "📝 update v0.11.0 changelog with agent-s..."}

[greptile-apps]

Hero image inventory is inaccurate

This entry says eight hero images were added but names nine skills, including git-remote-pr, which has no hero image in this changeset. This makes the published release inventory inaccurate; either remove git-remote-pr from the list or add its missing asset.

Suggested change

	- Hero images (`.jpg`) for eight skills providing visual identification and documentation rendering support: agent-smith, dotnet-benchmark, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, dotnet-test, and git-remote-pr,
	- Hero images (`.jpg`) for eight skills providing visual identification and documentation rendering support: agent-smith, dotnet-benchmark, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, and dotnet-test,

Prompt To Fix With AI

This is a comment left during a code review.
Path: CHANGELOG.md
Line: 25

Comment:
**Hero image inventory is inaccurate**

This entry says eight hero images were added but names nine skills, including `git-remote-pr`, which has no hero image in this changeset. This makes the published release inventory inaccurate; either remove `git-remote-pr` from the list or add its missing asset.

```suggestion
- Hero images (`.jpg`) for eight skills providing visual identification and documentation rendering support: agent-smith, dotnet-benchmark, dotnet-docfx-digest, dotnet-new-app-slnx, dotnet-new-lib-slnx, dotnet-remote-testing, dotnet-segregated-assets, and dotnet-test,
```

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.