Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
144 commits
Select commit Hold shift + click to select a range
6e2f499
✨ add dotnet-docfx-digest skill
aicia-bot Jun 8, 2026
4d75055
📝 document dotnet-docfx-digest in readme
aicia-bot Jun 8, 2026
303459b
♻️ refactor dotnet-docfx-digest to enforce mandatory overwrite examples
aicia-bot Jun 8, 2026
8923de1
♻️ clarify that type examples must appear on type pages
aicia-bot Jun 8, 2026
ee01044
♻️ simplify validator internal concepts and naming
aicia-bot Jun 8, 2026
7680636
💬 add markdown formatting guidelines
aicia-bot Jun 8, 2026
0d5f974
📝 sync README with refined type-example requirements
aicia-bot Jun 8, 2026
a271798
♻️ refactor dotnet-docfx-digest to verify docfx builds in temp workspace
aicia-bot Jun 8, 2026
509c57f
💬 update dotnet-docfx-digest description in available skills
aicia-bot Jun 8, 2026
ee29d95
♻️ add per-type docfx overwrite file support
aicia-bot Jun 8, 2026
83a1ed6
💬 update available skills documentation
aicia-bot Jun 8, 2026
0ddb4e7
♻️ restructure dotnet-docfx-digest skill documentation
aicia-bot Jun 8, 2026
b365789
💬 update available skills table for dotnet-docfx-digest
aicia-bot Jun 8, 2026
82db32c
♻️ enhance dotnet-docfx-digest with repair-plans and namespace covera…
aicia-bot Jun 8, 2026
179930b
✨ add repair-plan feature to docfx script
aicia-bot Jun 8, 2026
fbeff24
💬 update dotnet-docfx-digest skill description
aicia-bot Jun 8, 2026
9ed1720
♻️ strengthen safety gates and completion checks for documentation edits
aicia-bot Jun 8, 2026
250e46f
💬 update dotnet-docfx-digest description with safety gate features
aicia-bot Jun 8, 2026
4ab4b0d
♻️ clarify script resolution strategy in dotnet-docfx-digest skill
aicia-bot Jun 8, 2026
010f4ea
🔧 update dotnet-docfx-digest to resolve scripts from loaded skill dir
aicia-bot Jun 8, 2026
ec43e9c
♻️ add strong-name signing-key fallback handling
aicia-bot Jun 8, 2026
396d18b
💬 document keyless strong-name verification for signed repos
aicia-bot Jun 8, 2026
81d3e69
♻️ add Completion Repair Loop to docfx workflow
aicia-bot Jun 8, 2026
e657317
🐛 improve example validation diagnostics and reporting
aicia-bot Jun 9, 2026
7c7f813
🦺 validate sample skip-compile reasons strength
aicia-bot Jun 9, 2026
f8cac99
♻️ discover markdown from docfx config instead of scanning repo
aicia-bot Jun 9, 2026
f7f486f
♻️ refactor dotnet-docfx-digest guidance for clarity
aicia-bot Jun 9, 2026
11f255a
🔧 fix git diff command to include deleted files in docfx validator
aicia-bot Jun 9, 2026
f319be0
📚 Improve namespace documentation guidance in dotnet-docfx-digest
aicia-bot Jun 9, 2026
a4c3b3f
♻️ refine docfx project discovery logic
aicia-bot Jun 9, 2026
c52957a
🔧 refine docfx configuration in library scaffold
aicia-bot Jun 9, 2026
4313207
💬 update README with dotnet-docfx-digest skill
aicia-bot Jun 9, 2026
e7049dc
♻️ enhance dotnet-docfx-digest workflow and documentation
aicia-bot Jun 9, 2026
e2cf28c
💬 document blocking completion gates policy
aicia-bot Jun 9, 2026
267eaff
💬 update dotnet-docfx-digest skill description
aicia-bot Jun 10, 2026
4c8e7a6
♻️ refactor dotnet-docfx-digest skill structure and documentation
aicia-bot Jun 10, 2026
8bf8009
💬 update README with dotnet-docfx-digest updates
aicia-bot Jun 10, 2026
c0ac53a
✅ enhance docfx validation and evals
aicia-bot Jun 10, 2026
c600c4d
♻️ refactor dotnet-docfx-digest implementation and contracts
aicia-bot Jun 10, 2026
d87c04c
🔧 refine library scaffold docfx template
aicia-bot Jun 10, 2026
dfe7501
✅ expand docfx validation and evals
aicia-bot Jun 10, 2026
55b70bd
♻️ docfx validator: distinguish example forms in overwrite files
aicia-bot Jun 10, 2026
1cfc2bb
📚 docfx validator: document example form detection
aicia-bot Jun 10, 2026
1f8bcb7
✅ add validator tests for docfx overwrite example forms
aicia-bot Jun 10, 2026
235a16b
📚 docfx sample validation: document structure and compilation gates
aicia-bot Jun 10, 2026
1e1c92d
♻️ docfx validator: implement sample structure validation
aicia-bot Jun 10, 2026
d0e8d52
✅ add validator tests for sample structure validation
aicia-bot Jun 10, 2026
cc5fd17
♻️ refactor docfx validation to support parallel sample processing
aicia-bot Jun 11, 2026
412f4d4
📝 refresh docfx digest docs
aicia-bot Jun 11, 2026
d3d8d3a
📝 update docfx validation guidance
aicia-bot Jun 11, 2026
42ae0b6
📝 refresh docfx readme guidance
aicia-bot Jun 11, 2026
f4c1fbd
📝 refresh docfx skill notes
aicia-bot Jun 11, 2026
00b2d04
📚 add encoding and github search guidance to docfx-digest skill
aicia-bot Jun 12, 2026
95296c3
📖 update docfx-digest reference docs for encoding and search
aicia-bot Jun 12, 2026
6a9ede6
🔧 implement encoding validation and github example search
aicia-bot Jun 12, 2026
6643965
♻️ refactor docfx validation to fast-by-default with layered opt-in o…
aicia-bot Jun 13, 2026
79e6665
💬 clarify docfx-digest is fast by default with opt-in build/network o…
aicia-bot Jun 13, 2026
04d2ae8
♻️ refactor sample compilation to isolated projects in one graph build
aicia-bot Jun 13, 2026
98ac4c0
💬 clarify sample compilation strategy in readme
aicia-bot Jun 13, 2026
c592c43
♻️ refactor dotnet-docfx-digest workflow and test coverage
aicia-bot Jun 13, 2026
5013f4c
⚡️ enhance docfx script implementation
aicia-bot Jun 13, 2026
4320650
📝 update available skills in readme
aicia-bot Jun 13, 2026
bbf0ca8
♻️ refactor dotnet-docfx-digest workflow and test coverage
aicia-bot Jun 14, 2026
6908baf
⚡️ enhance docfx script implementation
aicia-bot Jun 14, 2026
bc62bde
📝 update available skills in readme
aicia-bot Jun 14, 2026
2388a77
🔨 add repo validation tooling
aicia-bot Jun 14, 2026
6c0db36
♻️ refactor dotnet-docfx-digest skill contract
aicia-bot Jun 14, 2026
e72d8b8
⚡️ enhance docfx skill implementation
aicia-bot Jun 14, 2026
bf9018e
📝 update available skills in readme
aicia-bot Jun 14, 2026
355ed97
🔨 extend repo validation tooling
aicia-bot Jun 14, 2026
aad6a5b
♻️ refactor dotnet-docfx-digest documentation
aicia-bot Jun 14, 2026
b3285a4
⚡️ enhance docfx skill implementation
aicia-bot Jun 14, 2026
16128c0
📝 update available skills in readme
aicia-bot Jun 14, 2026
201d91d
💬 update repo documentation and guidelines
aicia-bot Jun 15, 2026
0e61675
♻️ refactor dotnet-docfx-digest skill contract
aicia-bot Jun 15, 2026
c962bfc
⚡️ enhance docfx skill implementation
aicia-bot Jun 15, 2026
e702f9f
📝 update readme with skill enhancements
aicia-bot Jun 15, 2026
4612399
♻️ refactor dotnet-docfx-digest skill contract
aicia-bot Jun 15, 2026
4d86303
⚡️ enhance docfx script with targeted improvements
aicia-bot Jun 15, 2026
ada4fab
♻️ refine diagnostic iteration guidance in dotnet-docfx-digest
aicia-bot Jun 15, 2026
fb9057b
✨ expand eval test coverage for diagnostic transitions
aicia-bot Jun 15, 2026
e9f1ba2
📝 update readme for diagnostic iteration clarity
aicia-bot Jun 15, 2026
79ba0ab
⚡️ expand core authoring and execution guidance in dotnet-docfx-digest
aicia-bot Jun 15, 2026
1b6018f
✨ expand eval coverage for EXAMPLE_MISSING queue and execution semantics
aicia-bot Jun 15, 2026
4494acf
📝 update readme for expanded authoring and execution guidance
aicia-bot Jun 15, 2026
a754e5f
♻️ refactor dotnet-docfx-digest with assessment-queue terminology
aicia-bot Jun 15, 2026
85e5700
👷 add docfx cli install to skill template validator
aicia-bot Jun 15, 2026
fbdee2e
💬 update readme for assessment-queue changes
aicia-bot Jun 15, 2026
22d27d0
✨ add decorated extension method support to extension tables
aicia-bot Jun 15, 2026
e130a08
♻️ refactor dotnet-docfx-digest skill
aicia-bot Jun 15, 2026
48591d5
💬 sync skill description in readme
aicia-bot Jun 15, 2026
0b489ce
✅ add test harness for quality validation
aicia-bot Jun 15, 2026
113a16b
🧪 update extension-block eval for yaml path
aicia-bot Jun 15, 2026
d86ddd2
💬 sync skill description in readme
aicia-bot Jun 15, 2026
a0bbf7f
♻️ refactor dotnet-docfx-digest skill
aicia-bot Jun 15, 2026
2a54419
🔧 enhance validator and test infrastructure
aicia-bot Jun 15, 2026
8205075
💬 sync skill description in readme
aicia-bot Jun 15, 2026
dfbabe9
🔧 enhance validator and test infrastructure
aicia-bot Jun 16, 2026
4e93210
♻️ refactor skill documentation for synthetic uid handling
aicia-bot Jun 16, 2026
48c5842
💬 sync skill description in readme
aicia-bot Jun 16, 2026
62bc835
♻️ refactor dotnet-docfx-digest skill documentation
aicia-bot Jun 16, 2026
b3dd808
🔨 update dotnet-docfx-digest implementation scripts
aicia-bot Jun 16, 2026
2176df7
💬 sync readme with skill updates
aicia-bot Jun 16, 2026
ff7a1a4
📝 add anti-fatigue guidance to dotnet-docfx-digest skill
aicia-bot Jun 16, 2026
81ab5ce
♻️ refine docfx-digest skill documentation rules
aicia-bot Jun 16, 2026
2f24e42
♻️ refine example guidance in dotnet-docfx-digest
aicia-bot Jun 16, 2026
01306b3
🔨 enhance docfx validator with framework qualification gates
aicia-bot Jun 16, 2026
cc5da90
💬 sync readme with skill updates
aicia-bot Jun 16, 2026
4efefda
♻️ enhance example guidance in dotnet-docfx-digest
aicia-bot Jun 16, 2026
abc3bb1
🔨 add factory-origin pattern test to docfx validation
aicia-bot Jun 16, 2026
6a42730
💬 sync readme with example guidance updates
aicia-bot Jun 16, 2026
3fb42cb
♻️ refactor interim artifact validation in dotnet-docfx-digest
aicia-bot Jun 17, 2026
fb5c417
🔨 enhance interim artifact cleanup and test isolation
aicia-bot Jun 17, 2026
57af3dc
💬 sync readme with interim artifact handling updates
aicia-bot Jun 17, 2026
57f7242
♻️ auto-detect generic-arity type families
aicia-bot Jun 17, 2026
d3780ba
📝 correct antigravity-cli path references
aicia-bot Jun 17, 2026
8411e0d
🔧 enhance static class detection in API discovery
aicia-bot Jun 18, 2026
c52abdd
🔧 update docfx script path to use resolved skill directory
aicia-bot Jun 18, 2026
a9d466f
🦺 detect public delegates and improve extension method validation
aicia-bot Jun 18, 2026
434cea4
✅ add regression tests for delegate and extension discovery
aicia-bot Jun 18, 2026
4a61e00
♻️ document extension method validation in skill contract
aicia-bot Jun 18, 2026
8c3ed62
💬 add extension method validation to feature list
aicia-bot Jun 18, 2026
e59db30
🦺 validate extension method names against source
aicia-bot Jun 18, 2026
f416fa8
✅ add regression test for invented extension methods
aicia-bot Jun 18, 2026
f09ae86
♻️ refine namespace prose guidance in skill contract
aicia-bot Jun 18, 2026
623349d
💬 add namespace prose guidance to feature list
aicia-bot Jun 18, 2026
7446f7a
✨ add example lead narrative validation
aicia-bot Jun 18, 2026
ec86f44
📝 document example lead validation in skill contract
aicia-bot Jun 18, 2026
e509c84
📝 update validation references for example narrative
aicia-bot Jun 18, 2026
dbd81a5
💬 announce example lead narrative feature
aicia-bot Jun 18, 2026
52a78aa
♻️ enforce completion contract in skill docs
aicia-bot Jun 20, 2026
86eba35
📝 add blocking repair guidance to validator
aicia-bot Jun 20, 2026
5acf736
💬 announce completion contract enforcement feature
aicia-bot Jun 20, 2026
637238f
✨ add scope-aware blocking ownership diagnostics
aicia-bot Jun 20, 2026
5d9f5ab
♻️ document ownership validation in skill contract
aicia-bot Jun 20, 2026
d402e16
💬 announce ownership validation feature
aicia-bot Jun 20, 2026
3a0c124
♻️ enhance conditional API validation in dotnet-docfx-digest
aicia-bot Jun 20, 2026
522bdfe
💬 document conditional API validation in README
aicia-bot Jun 20, 2026
950b80a
✨ update changelog for v0.7.0 release with new features and changes
aicia-bot Jun 20, 2026
17362b9
✨ add escape hatch markers with pre-approved allowlist support
aicia-bot Jun 20, 2026
4620687
♻️ enhance skill contract for escape hatch markers
aicia-bot Jun 20, 2026
88d69b1
💬 announce escape hatch markers feature
aicia-bot Jun 20, 2026
8eaf108
♻️ strengthen context exhaustion protocol in dotnet-docfx-digest
aicia-bot Jun 20, 2026
67f7d7c
📝 clarify full docfx verification gates in governance
aicia-bot Jun 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .github/workflows/validate-skill-templates.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,17 @@ jobs:
- name: Checkout
uses: actions/checkout@v4

- name: Install DocFX CLI
shell: pwsh
run: |
if (Get-Command docfx -ErrorAction SilentlyContinue) {
dotnet tool update --global docfx
} else {
dotnet tool install --global docfx
}
"$HOME/.dotnet/tools" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
docfx --version

- name: Run validator
shell: pwsh
run: pwsh -NoProfile -File ./scripts/validate-skill-templates.ps1
26 changes: 21 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Repo-managed skills live in four places that must stay in sync:
- `skills/<name>/` — source control (and source of truth for edits)
- `~/.claude/skills/<name>/` — local Claude install
- `~/.agents/skills/<name>/` — local global agent install
- `~/.gemini/antigravity/skills/<name>/` — local Gemini Antigravity install
- `~/.gemini/antigravity-cli/skills/<name>/` — local Gemini Antigravity install

Changes often start in `~/.claude/skills/<name>/`, then get mirrored to the repo and the other local installs:

Expand All @@ -72,22 +72,24 @@ Changes often start in `~/.claude/skills/<name>/`, then get mirrored to the repo
- **Claude local → agent installs** (keep `~/.agents` and Gemini current):
```powershell
Copy-Item "$HOME/.claude/skills/<name>/<file>" "$HOME/.agents/skills/<name>/<file>" -Force
Copy-Item "$HOME/.claude/skills/<name>/<file>" "$HOME/.gemini/antigravity/skills/<name>/<file>" -Force
Copy-Item "$HOME/.claude/skills/<name>/<file>" "$HOME/.gemini/antigravity-cli/skills/<name>/<file>" -Force
```
- **Repo → local installs** (after pulling changes or cloning fresh):
```powershell
Copy-Item "skills/<name>/<file>" "$HOME/.claude/skills/<name>/<file>" -Force
Copy-Item "skills/<name>/<file>" "$HOME/.agents/skills/<name>/<file>" -Force
Copy-Item "skills/<name>/<file>" "$HOME/.gemini/antigravity/skills/<name>/<file>" -Force
Copy-Item "skills/<name>/<file>" "$HOME/.gemini/antigravity-cli/skills/<name>/<file>" -Force
```

If you edit the `~/.agents/skills/<name>/` copy first, mirror it back to the repo and to `~/.claude/skills/<name>/` and `~/.gemini/antigravity/skills/<name>/` using the same pattern.
If you edit the `~/.agents/skills/<name>/` copy first, mirror it back to the repo and to `~/.claude/skills/<name>/` and `~/.gemini/antigravity-cli/skills/<name>/` using the same pattern.

When renaming a skill, update **all four** locations — the repo folder, the local Claude install folder, the local global agent install folder, and the local Gemini Antigravity install folder. The folder name and the `name:` field in the SKILL.md frontmatter must match. A mismatch causes the skill to disappear from tooling or show stale instructions.

A sync mismatch means one side runs a stale version, which leads to confusing eval results and wasted iterations.

After changing any repo-managed skill, sync the touched files across the repo copy, `~/.claude/skills/<name>/`, `~/.agents/skills/<name>/`, and `~/.gemini/antigravity/skills/<name>/` before considering the task done.
After the source copy passes its deterministic tests, SHA-256 identity across the repo and all three local installs is sufficient installation verification. Do not rerun the same deterministic suites from a hash-identical installed copy; that duplicates time, compute, and token use without adding evidence. Run an installed-copy test only when install-path resolution, loader behavior, permissions, or an actual hash mismatch is the subject of the test.

After changing any repo-managed skill, sync the touched files across the repo copy, `~/.claude/skills/<name>/`, `~/.agents/skills/<name>/`, and `~/.gemini/antigravity-cli/skills/<name>/` before considering the task done.

## Skill Directory Structure

Expand Down Expand Up @@ -141,10 +143,24 @@ When committing changes to this repo, group by technology and logical purpose
- Template files (`.csproj`, `.yml`, `.cs`) get their own commit(s)
- Documentation updates (`README.md`, `CONTRIBUTING.md`) get their own commit

## Markdown Formatting

All markdown files in this repository must use natural paragraph flow. Do not artificially break paragraphs at fixed column widths or insert hard line breaks within sentences. Paragraphs should flow as complete thoughts, allowing line wrapping to be determined by the reader's viewport or rendering engine, not by arbitrary character limits.

**Why:** Natural paragraphs are more readable, easier to edit, and render correctly across all devices and markdown renderers. Artificially clipped paragraphs create maintenance friction and look awkward in source control diffs.

## README Sync

After modifying any skill (`SKILL.md`, `FORMS.md`) or repo-level config (`AGENTS.md`), **always update `README.md` before considering the task done**. This is a mandatory gate — not a nice-to-have. The README's "Available Skills" table, install examples, and "Why" sections must reflect the current state of all skills. A new skill without a README entry is incomplete work.

## Blocking Completion Gates

When repository guidance, an active skill, or a conversation summary identifies required follow-up work as pending, critical, blocking, or equivalent, treat those items as the active completion checklist for the current task rather than as background context. Do not call `task_complete`, describe the task as complete, or claim verification succeeded until every blocking item has either run successfully or been reported with the exact command, exit code, and remaining blocker.

Before any completion message, reread the skill instructions and the current conversation summary's pending-task or blocker sections. If either one names a required script, validator, or maintenance step, that step is a hard gate, not optional polish.

For script-backed workflows, creating or editing files is not enough on its own. If a skill requires deterministic maintenance or verification commands, run them before completion and report their concrete outcome. For `dotnet-docfx-digest`, `scripts/agents.cs` and `scripts/docfx.cs --build-api-model --validate-samples --verify-docfx-build` are blocking completion gates whenever the skill or task summary says they are required.

## User Input UX

When a skill collects parameters from the user, define the form in a dedicated `FORMS.md` file (Level 3 resource) rather than inlining field definitions in `SKILL.md`. This separates form structure from workflow logic and gives agents a parseable format to present fields correctly.
Expand Down
20 changes: 19 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),

## [Unreleased]

## [0.7.0] - 2026-06-20

This is a minor release adding scope-aware ownership validation, completion contract enforcement, and enhanced conditional API validation guidance to the dotnet-docfx-digest skill.

### Added

- Scope-aware ownership validation in dotnet-docfx-digest that requires exact-UID examples or receiver-style examples to resolve cross-assembly collisions, converting SYMBOL_COLLISION_UNRESOLVED and EXTENSION_OWNER_AMBIGUOUS from warnings to blocking errors,
- Blocking completion contract enforcement: diagnostics such as EXAMPLE_LEAD_MISSING, EXAMPLE_ADVANCED_LEAD_MISSING, FAMILY_ANCHOR_EXAMPLE_MISSING, SAMPLE_STRUCTURE_INVALID, and INTERIM_ARTIFACT_IN_WORKTREE are now blocking repair items rather than optional quality backlog,
- Enhanced conditional API validation guidance for selecting executable test frameworks from the asset containing a conditionally compiled API, with specific rules for NETSTANDARD2_0, modern asset variants, and framework selection via asset resolution confirmation,
- Eval cases 106, 107, and 108 covering completion contract enforcement, scope-aware ownership validation, and conditional API framework selection.

### Changed

- Extended dotnet-docfx-digest SKILL.md with completion contract details, scope-aware ownership validation rules, and conditional API framework selection logic,
- Enhanced docfx.cs help text and agents.cs prompt guidance with ownership validation and conditional API framework selection documentation,
- Expanded workflow.md and scripts.md references with scope-aware validation logic and framework selection rules.

## [0.6.0] - 2026-06-08

This is a minor release introducing the `dotnet-change-impact` skill for classifying .NET library and NuGet package changes against Microsoft's official compatibility rules. The skill automatically resolves the current branch against the upstream default branch, compares commits and diffs, and recommends the correct SemVer release bump (Major, Minor, or Patch) along with structured compatibility reasoning.
Expand Down Expand Up @@ -341,7 +358,8 @@ This is a minor release that introduces two complementary git workflow skills, e

- Improved scaffold fidelity with hidden `.bot` asset preservation, explicit UTF-8 and BOM handling, and checks aimed at preventing mojibake or incomplete generated output.

[Unreleased]: https://github.com/codebeltnet/agentic/compare/v0.6.0...HEAD
[Unreleased]: https://github.com/codebeltnet/agentic/compare/v0.7.0...HEAD
[0.7.0]: https://github.com/codebeltnet/agentic/compare/v0.6.0...v0.7.0
[0.6.0]: https://github.com/codebeltnet/agentic/compare/v0.5.0...v0.6.0
[0.5.0]: https://github.com/codebeltnet/agentic/compare/v0.4.6...v0.5.0
[0.4.6]: https://github.com/codebeltnet/agentic/compare/v0.4.5...v0.4.6
Expand Down
Loading
Loading