Skip to content

Commit c19a1dc

Browse files
πŸ“– [Docs]: Move Agentic-Development from Frameworks into Capabilities (#109)
Agentic-Development framework moves from the standalone Frameworks section into Capabilities, unifying the capability and framework concepts under a single spec-and-design model. The framework now lives alongside every other capability β€” Release Management, Dependency Updates, Merge Automation, Downstream Release Propagation, VS Code Extension Framework, PowerShell on GitHub, and Process-PSModule β€” all documented consistently by spec (why and what) and design (how). ## Changed: Agentic-Development location and navigation Agentic-Development now appears under Capabilities in the documentation site navigation. All four pages (spec.md, design.md, index.md, memory-template.md) retain their content, front matter, and internal structure β€” only their storage location and navigation path changed. The memory-template.md is still the canonical reference for teams setting up an Agentic Development org-wide memory repository. Links throughout the ecosystem that pointed to the old `Frameworks/Agentic-Development/...` path now point to `Capabilities/agentic-development/...`. The relative link depth is unchanged β€” both old and new locations are two levels under `src/docs`, so cross-document references like `../../Ways-of-Working/...` continue to work without modification. --- <details> <summary>Technical details</summary> - Folder moved via `git mv` to preserve commit history: `src/docs/Frameworks/Agentic-Development/` β†’ `src/docs/Capabilities/agentic-development/` - Folder name follows lowercase-kebab convention (matches `release-management`, `dependency-updates`, `process-psmodule`, etc.) - `src/zensical.toml`: Added Agentic Development group under Capabilities nav (index.md, Spec, Design, Memory Repository Template); removed from Frameworks nav - Inbound links fixed: `src/docs/Ways-of-Working/Repository-Type-Property.md` (2 occurrences) updated to reference new path - `src/docs/Frameworks/index.md`: Removed Agentic-Development entry; Frameworks section now states retirement pending - Auto-generated indexes regenerated: `Capabilities/index.md` and `Frameworks/index.md` updated by `Update-DocumentationIndex.ps1` - All validation passing: `Test-DocumentationLink.ps1` confirms all links resolve; markdownlint reports 0 issues - Rebased on main (commit c714245) after PR #110 merged Process-PSModule to Capabilities; merge-tree confirms zero conflicts </details> <details> <summary>Relevant issues</summary> - Resolves #107 - #102 </details> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent c714245 commit c19a1dc

9 files changed

Lines changed: 7 additions & 40 deletions

File tree

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

β€Žsrc/docs/Capabilities/index.mdβ€Ž

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ and design relate and evolve.
2323
| [VS Code Extension Framework](vscode-extension-framework/index.md) | How a VS Code extension is built, tested, versioned, packaged, and published β€” one GitHub-native pipeline, opt-in from a template and a single settings file. |
2424
| [PowerShell on GitHub](powershell-on-github/index.md) | How we make GitHub a first-class platform for PowerShell through reusable modules, actions, and capability gaps we close over time. |
2525
| [Process-PSModule](process-psmodule/index.md) | The end-to-end PowerShell module pipeline β€” what it must guarantee and how it is built, alongside reference documentation for configuration and deployment. |
26+
| [Agentic Development](agentic-development/index.md) | The framework for org-scoped docs and memory repositories that give agents project-specific standards, working knowledge, and behavior. |
2627

2728
<!-- INDEX:END -->
2829

β€Žsrc/docs/Frameworks/index.mdβ€Ž

Lines changed: 0 additions & 30 deletions
This file was deleted.

β€Žsrc/docs/Ways-of-Working/Repository-Type-Property.mdβ€Ž

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Both current MSX initiative organizations use this pattern:
9999
| `PSModule` | `Action`, `Archive`, `Docs`, `Framework`, `FunctionApp`, `Memory`, `Module`, `Other`, `Template`, `Workflow` | `Memory` added to an existing, already-populated `Type` property; the ruleset condition changed from a repository-name allow-list (`~ALL`) to a `Type`-based exclude. |
100100

101101
In both organizations, repositories with `Type: Memory` β€” the
102-
[Memory Repository Template](../Frameworks/Agentic-Development/memory-template.md)'s
102+
[Memory Repository Template](../Capabilities/agentic-development/memory-template.md)'s
103103
no-PR, direct-commit-to-`main` repositories β€” are excluded from the org-wide pull-request-
104104
required ruleset. That template's workflow only works because the ruleset stops matching
105105
`Memory`-typed repositories; without this, direct pushes to a memory repository's `main`
@@ -112,6 +112,6 @@ are rejected the same as on any other repository.
112112
rules attached to them.
113113
- [Repository Standard](Repository-Standard.md) β€” the mandatory/type-specific/
114114
repository-specific file-set distinction that `Type` also drives over time.
115-
- [Memory Repository Template](../Frameworks/Agentic-Development/memory-template.md) β€” the
115+
- [Memory Repository Template](../Capabilities/agentic-development/memory-template.md) β€” the
116116
concrete repository type whose no-PR workflow motivated excluding `Type: Memory` from the
117117
pull-request-required ruleset in both current organizations.

β€Žsrc/docs/index.mdβ€Ž

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,6 @@ Each area below carries its own index. Start here, read the descriptions, and fo
4949
| [Ways of Working](Ways-of-Working/index.md) | How work happens across the ecosystem β€” for humans and agents alike. |
5050
| [Coding Standards](Coding-Standards/index.md) | The shared baseline every repository inherits, and the per-language standards that build on it. |
5151
| [Capabilities](Capabilities/index.md) | The capabilities the ecosystem builds, each documented by a spec (why and what) and a design (how and what). |
52-
| [Frameworks](Frameworks/index.md) | The complete, end-to-end frameworks the ecosystem ships β€” opinionated automation a project adopts wholesale to go from source to shipped. |
5352
| [Dictionary](Dictionary/index.md) | Shared vocabulary for the MSX ecosystem β€” the terms a reader or agent meets across these docs. |
5453

5554
<!-- INDEX:END -->

β€Žsrc/zensical.tomlβ€Ž

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -154,14 +154,11 @@ nav = [
154154
{"Repository Structure" = "Capabilities/process-psmodule/repository-structure.md"},
155155
{"Principles and Practices" = "Capabilities/process-psmodule/principles-and-practices.md"},
156156
]},
157-
]},
158-
{"Frameworks" = [
159-
"Frameworks/index.md",
160157
{"Agentic Development" = [
161-
"Frameworks/Agentic-Development/index.md",
162-
{"Spec" = "Frameworks/Agentic-Development/spec.md"},
163-
{"Design" = "Frameworks/Agentic-Development/design.md"},
164-
{"Memory Repository Template" = "Frameworks/Agentic-Development/memory-template.md"},
158+
"Capabilities/agentic-development/index.md",
159+
{"Spec" = "Capabilities/agentic-development/spec.md"},
160+
{"Design" = "Capabilities/agentic-development/design.md"},
161+
{"Memory Repository Template" = "Capabilities/agentic-development/memory-template.md"},
165162
]},
166163
]},
167164
{"Dictionary" = "Dictionary/index.md"},

0 commit comments

Comments
Β (0)