ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
25e1f69513
TenantAtlas/docs
History
ahmido 25e1f69513 docs: re-audit planning docs and prep guardrails (#317) 
## Summary
- re-audit `docs/product/spec-candidates.md` so completed or already prepared specs are no longer exposed as active `next-best-prep` targets
- refresh `docs/product/implementation-ledger.md` to align maturity and readiness wording with current repo-backed evidence
- include the existing `spec-kit-next-best-prep` guardrail update so completed specs are not rewritten back into preparation state

## Validation
- not run (docs-only changes)

## Notes
- no files under `specs/` were modified
- no application or runtime files were modified

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #317
2026-05-01 21:07:35 +00:00
..
audits chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
product docs: re-audit planning docs and prep guardrails (#317) 2026-05-01 21:07:35 +00:00
research chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
security chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
strategy chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
ui chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
HANDOVER.md chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
PERMISSIONS.md chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
PROJECT_SUMMARY.md chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00
README.md chore: commit all changes (automated) 2026-04-30 16:25:12 +02:00

README.md

TenantPilot Documentation Index

Status: Active
Last reviewed: 2026-04-30
Use for: Navigating current documentation sources and understanding how to maintain them with low overhead
Do not use for: Assuming any document is implementation truth without repo verification

Current Source of Truth

  • docs/product/roadmap.md - current product roadmap and prioritization context
  • docs/product/spec-candidates.md - active spec candidate queue
  • docs/product/principles.md - product and architecture principles
  • docs/strategy/product-vision.md - long-term product vision
  • docs/strategy/domain-coverage.md - domain and coverage strategy

Product Operations

  • docs/product/discoveries.md
  • docs/product/implementation-ledger.md
  • docs/product/prompts/
  • docs/product/standards/

Technical Research

  • docs/research/

UI Standards

  • docs/ui/

Audits

  • docs/audits/

Security And Access References

  • docs/PERMISSIONS.md
  • docs/security/

Historical Or Superseded Material

  • docs/audits/archive/
  • audit-derived candidate documents that are marked Historical, Superseded, or Needs Review

Lightweight Maintenance Model

  • Keep only the current source-of-truth documents actively maintained.
  • Update a document when the underlying roadmap, policy, or decision actually changes.
  • Mark older material with status headers instead of rewriting it to feel current.
  • Prefer archive or superseded markers over deletion.
  • Verify implementation claims against repo code, specs, and tests.

Rules For Agents

  • Treat docs as guidance, not implementation truth.
  • Verify implementation claims against repo code.
  • Specs are not automatically implemented.
  • Tests are not automatically executed.
  • Historical audits may be outdated.
  • Prefer current roadmap and spec-candidates for prioritization.