Skip to content

Align agent context paths with organization repositories #191

Closed

Description

Context and request

Canonical agent documentation must use real repository identities. The Agentic Development design still names PSModule/docs, which does not exist, instead of the repository that owns PSModule process and standards.

Acceptance criteria

  • The Agentic Development design identifies MSXOrg/docs and PSModule/Process-PSModule as the canonical documentation repositories.
  • The framework does not prescribe where documentation repositories are cloned locally.
  • The newly agreed repository router and AGENTS.md template from main remain unchanged.
  • Related documentation uses the same repository model.
  • Shared agent context is documentation-only.

Constraints and non-goals

  • This change does not duplicate standards inside product repositories.
  • This change does not prescribe a new router format, bootstrap implementation, or local filesystem layout.

Technical decisions

  • Repository identity is authoritative.
  • Runtime and development setup own local checkout placement.
  • PSModule/Process-PSModule owns PSModule process and standards content.
  • Existing Git freshness requirements remain unchanged.

Implementation plan

  • Integrate the latest main changes.
  • Preserve the newly agreed root router and canonical AGENTS.md template unchanged.
  • Align the Agentic Development source-repository model.
  • Remove prescribed local clone paths and remaining shared-context-store guidance.
  • Validate documentation, indexes, links, formatting, and the explicit Copilot review loop.

Activity

  1. MariusStorhaug commented on Aug 29, 2026

    @MariusStorhaug
    MemberAuthor

    Contract tests for repository identities, organization-named paths, router metadata, and fail-closed former-layout handling are committed in f142e44. Draft PR #194 is open; bootstrap and documentation implementation follow.

  2. MariusStorhaug commented on Aug 29, 2026

    @MariusStorhaug
    MemberAuthor

    Bootstrap implementation is committed in 61b134b. Canonical Agentic Development sources and paths are aligned in 2ee22c7, and routers plus migration guidance are aligned in 34a4147. Targeted bootstrap/router tests pass; repository-wide validation is in progress on draft PR #194.

  3. MariusStorhaug commented on Aug 29, 2026

    @MariusStorhaug
    MemberAuthor

    Implementation is complete in draft PR #194. All local and CI validation passes, including 98 Pester tests, documentation indexes, site build, internal and cross-repository links, Markdown, natural-language, and PowerShell linting. Copilot review reached a clean round after both in-scope path-safety findings were fixed and resolved. The PR remains draft for human review.

  4. added a commit that references this issue on Sep 4, 2026
    8122ae2
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions