docs: reconcile AGENTS.md with GA scope

[shreemaan-abhishek]

Summary

Bring AGENTS.md in line with the GA Readiness Handoff (#22) so the development guide reflects the code as it actually is.

• pkg/cmd/ tree now matches the actual directories on disk (drops auth, token, user, role, permission-policy, custom-plugin, portal, audit-log, route-template, service-registry, secret-provider).
• pkg/api/ types list matches the files on disk (drops the fictional types_token.go, adds types_consumer_group.go, types_credential.go, types_plugin.go, types_plugin_metadata.go, types_global_rule.go, types_stream_route.go, types_secret.go, types_proto.go, types_config.go, plus pkg/listutil/ and pkg/selector/).
• Document Map adds skills.md, documentation-maintenance.md, ga-test-plan.md, ga-test-report.md, and user-guide/.
• "API7 EE vs APISIX Differences" reframes enterprise modules (RBAC, portal, audit logs, custom plugins, service registries, access-token management) as out of scope for GA and points at the deferred sections in PRD.md / docs/roadmap.md.
• Commit-scope example drops the unimplemented token scope and lists the actually-shipped scopes.

PRD.md and docs/roadmap.md changes that were on this branch earlier were reverted at the author's request; this PR is AGENTS.md only.

Refs #28. Part of #22.

Test plan

• Confirm every pkg/cmd/<dir> and pkg/api/types_*.go referenced in AGENTS.md exists on disk.
• Confirm every docs/*.md referenced in the Document Map exists.
• CI green on the branch.

[coderabbitai]

📝 Walkthrough

Walkthrough

Three documentation files are updated to align GA scope and deferral strategy: PRD.md redefines goals and command surface for management-plane stability, AGENTS.md updates architecture/structure documentation, and docs/roadmap.md transitions to a GA-centric phase completion and readiness model with explicit post-GA deferrals.

Changes

GA Scope Documentation Alignment

Layer / File(s)	Summary
GA Scope Definition and Command Surface PRD.md	Design philosophy anchors to "management-plane stability" GA with deferred enterprise modules. Goals rewritten into GA-scoped checklist mandating access-token authentication, gateway-group control, and file-based CRUD/declarative operations. a7ee access tokens marked GA-supported; session login deferred. Command surface updated: gateway-group commands added, service templates marked "Not supported in GA," control-plane modules (tokens, RBAC, portal, custom plugins, system, audit logs) moved to deferred section. Feature parity table marks bulk operations, interactive mode, and extension system as post-GA.
Architecture Documentation Refresh AGENTS.md	Document Map and Project Structure tables rewritten to reflect current command/module layout. API7 EE vs APISIX Differences section emphasizes gateway-group scoping, token/prefix conventions, JSON Patch behavior, and GA scope boundaries. Resources NOT Exposed section clarified to exclude deferred enterprise modules. Commit message scope examples expanded.
Roadmap Phase Completion and GA Readiness docs/roadmap.md	Introduction replaced: Phases 1–8 declared complete; Phase 9 deferred post-GA with management-plane focus. Completed Phases table finalized with pointer to PRD goals checklist. Remaining PR summary replaced by GA Readiness Handoff section (issue #22 anchor) enumerating detailed exit criteria and test plan references. Phase 9 Enterprise Features section replaced by Deferred (Post-GA) section listing token management, RBAC, developer portal, custom plugins, audit logs, system settings, session login, interactive mode, extension/plugin system, and bulk operations.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• api7/a7#40: Both PRs update GA/scoping docs around "resources not exposed in API7 EE"—the main PR refreshes that documentation coverage (AGENTS/PRD/roadmap) while PR #40 removes the corresponding not-exposed resource stubs from docs/api7ee-api-spec.md.

🚥 Pre-merge checks | ✅ 6

✅ Passed checks (6 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	All objectives from issue #28 are met: PRD.md, docs/roadmap.md, and AGENTS.md are reconciled with GA scope; Phase 9 enterprise content is deferred; and non-existent pkg/cmd/ directories are removed.
Out of Scope Changes check	✅ Passed	All changes are documentation-only updates directly tied to GA scope reconciliation; no code changes or unrelated edits are present.
E2e Test Quality Review	✅ Passed	PR addresses issue #28: AGENTS.md lists only existing pkg/cmd/ dirs, PRD.md adds "Deferred (Post-GA)", roadmap.md removes stale "Phase 5". Documentation changes verified against actual repo state.
Security Check	✅ Passed	Documentation-only PR with no code changes. No credentials leaked, no secrets exposed, no auth bypasses. Example tokens use placeholders (a7ee.xxxxxxxxxx/yyyyyyyyyy).
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title 'docs: reconcile AGENTS.md with GA scope' directly reflects the main changeset, which reconciles three documentation files (AGENTS.md, PRD.md, and docs/roadmap.md) with GA scope.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/reconcile-ga-scope-28

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}