TenantAtlas/specs/416-tenantpilot-agent-skill-layer-v1/checklists/requirements.md
ahmido 332f6325cb feat: add tenantpilot agent skill layer v1 (#483)
Automated PR provided by Codex via Gitea API.

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #483
2026-06-25 23:03:47 +00:00

5.8 KiB

Requirements Checklist: Spec 416 - TenantPilot Agent Skill Layer V1 and Router Integration

Correction Completeness

  • CHK001 spec.md is renamed conceptually to include Agent Skill Layer V1 and Router Integration.
  • CHK002 plan.md identifies .agent/skills/**, AGENTS.md, optional docs/agent-workflow.md, and Spec 416 files as the only future implementation surfaces.
  • CHK003 tasks.md is reset for future implementation and uses unchecked implementation tasks.
  • CHK004 The spec correction itself is documentation/spec-only.
  • CHK005 Runtime application files remain out of scope.

Candidate Selection Gate

  • CHK010 The correction explicitly supersedes the earlier .codex/skills/**-only target.
  • CHK011 .agent/skills/** is now the skill library.
  • CHK012 AGENTS.md is now the activation/router entry point.
  • CHK013 Basic router integration is not deferred to a future Spec 417.
  • CHK014 Related Specs 395, 400, 402, 414, and 415 remain read-only context and not preparation targets.
  • CHK015 The candidate is scoped as repository workflow/documentation only.
  • CHK016 Candidate Selection Gate result: PASS.

Repo Truth And Scope

  • CHK020 The corrected future implementation scope is limited to .agent/skills/**, AGENTS.md, optional docs/agent-workflow.md, and specs/416-tenantpilot-agent-skill-layer-v1/**.
  • CHK021 .codex/skills/** is not the corrected Spec 416 implementation target.
  • CHK022 Runtime application files are forbidden.
  • CHK023 Tests, migrations, config, routes, resources, services, policies, jobs, package files, and lock files are forbidden.
  • CHK024 Completed specs must not be rewritten.

Mandatory Spec Sections

  • CHK030 Spec Candidate Check is complete with approval class, score, red flags, and decision.
  • CHK031 Spec Scope Fields are complete.
  • CHK032 Deliverables are complete.
  • CHK033 Required Skill Structure is complete.
  • CHK034 AGENTS.md Router Integration Requirements are complete.
  • CHK035 UI Surface Impact is checked as No UI surface impact with rationale.
  • CHK036 Product Surface Impact is N/A - no rendered product surface changed.
  • CHK037 Browser Verification Plan is N/A - no rendered UI surface changed.
  • CHK038 Human Product Sanity is N/A for rendered product UI.
  • CHK039 Cross-Cutting / Shared Pattern Reuse is completed for repository workflow.
  • CHK040 OperationRun UX Impact is N/A.
  • CHK041 Provider Boundary / Platform Core Check is N/A for runtime seams.
  • CHK042 Proportionality Review is complete because a workflow/skill abstraction and router are introduced.
  • CHK043 Testing / Lane / Runtime Impact is complete with artifact/router-only validation.
  • CHK044 Test Governance outcome is keep with no runtime/test/browser/heavy-governance lane expansion.

Requirements Coverage

  • CHK050 README requirements are listed.
  • CHK051 Required skill headings are listed.
  • CHK052 All 11 V1 skill files are listed as functional requirements and tasks.
  • CHK053 Router requirements are listed.
  • CHK054 The quarantine list is explicit.
  • CHK055 TCM temporary expiry requirement is explicit.
  • CHK056 No generic standards-only skills requirement is explicit.
  • CHK057 No runtime/application/test/migration/config/package changes requirement is explicit.
  • CHK058 Implementation report requirements are explicit.
  • CHK059 Allowed and forbidden final implementation paths are explicit.
  • CHK060 Verification commands include AGENTS.md router checks.

Task Readiness

  • CHK070 Tasks are grouped by phase.
  • CHK071 Tasks are unchecked and suitable for the corrected implementation loop.
  • CHK072 Tasks include preflight repo verification before writing skill files.
  • CHK073 Tasks include .agent/skills/README.md creation.
  • CHK074 Tasks include every repo-contract skill.
  • CHK075 Tasks include every workflow skill.
  • CHK076 Tasks include the temporary migration skill.
  • CHK077 Tasks include AGENTS.md router integration.
  • CHK078 Tasks include verification commands.
  • CHK079 Tasks include implementation-report close-out.
  • CHK080 Tasks include explicit non-goals.

Router Integration Readiness

  • CHK090 AGENTS.md must contain a TenantPilot Agent Skill Router section.
  • CHK091 Router must tell agents to read .agent/skills/README.md.
  • CHK092 Router must tell agents to activate only relevant skills.
  • CHK093 Router must tell agents not to load all skills by default.
  • CHK094 Router must tell agents to report activated skills and reasons before implementation or review.
  • CHK095 Router must treat hard-gate stop conditions as blockers.
  • CHK096 Router must require branch, HEAD, and dirty state before file changes.
  • CHK097 Router must say current repo evidence beats historical prompts.
  • CHK098 Router must say inventory-only specs are hints, not hard evidence.
  • CHK099 Router must say temporary skills require expiry/review criteria.

Spec Readiness Gate

  • CHK100 spec.md, plan.md, tasks.md, and checklists/requirements.md exist.
  • CHK101 Problem statement, user value, functional requirements, non-goals, acceptance/success criteria, assumptions, risks, and open questions are present.
  • CHK102 The plan identifies affected repo surfaces and avoids application runtime changes.
  • CHK103 Tasks are small, ordered, and verifiable.
  • CHK104 RBAC, workspace isolation, OperationRun, evidence/result truth, customer-output, provider freshness, Product Surface, Filament/Livewire, browser audit, temporary migration, and router concerns are addressed as skill/router content where relevant.
  • CHK105 No open question blocks safe implementation.
  • CHK106 Scope is small enough for a bounded implementation loop.
  • CHK107 Spec Readiness Gate result: PASS.