Skip to content

chore: require readable capability layers and contextual refactoring #102

Open

Description

@adrianwebb

Goal

Make small, cohesive TypeScript classes and readable capability orchestration a critical development rule. Add the identical shared AGENTS.md rule, contextual refactoring obligation, release-workflow guidance and a development-only twenty-line method check.

Acceptance criteria

  • Documentation committed before outside-in tests and implementation.
  • Preserve project-specific instructions, licenses, repository boundaries and API committer policy.
  • Canonically formatted new/changed executable methods have at most twenty body lines, with exact reviewed exemptions.
  • Unchanged debt is pinned to verified origin/cordis; changed methods cannot acquire baseline exemptions.
  • Reject compressed statements, stale exemptions and baseline manipulation; normal owner checks/CI run the helper.
  • Preserve all existing test registrations and frozen historical artifacts; qualify normal owner gates and genuine helper invocation.
  • Open bounded cordis review candidate; keep this and all issues including platform#678 open.

Authority and scope

Maintainer approved the seed-driven Task 3D plan and explicitly requested this policy first across the nine initialized Cordis repositories and shared future setup. This is a separate policy delivery from runtime functionality under treeseed-ai/platform#773. Legacy repositories, TreeDX and AI remain untouched. No merge or production release is authorized.

Activity

  1. adrianwebb commented on Oct 27, 2026

    @adrianwebb
    ContributorAuthor

    Progress Update

    Completed:

    Remaining:

    • Maintainer review of the unmerged candidate. No Task 3D runtime completeness is claimed.

    This issue and all release issues remain open; no merge or release has been performed.

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

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions