Skip to content

docs: add the product requirements document - #174

Merged
lippdev merged 4 commits into
mainfrom
docs/prd
Oct 29, 2026
Merged

lippdev merged 4 commits into
mainfrom
docs/prd

Conversation

@lippdev

@lippdev lippdev commented Oct 29, 2026 •

Copy link
Copy Markdown
Owner

What

Adds docs/PRD.md, the product requirements document and backlog, in Portuguese and in the same format as the Tako PRD:

  • header with version, date, status, platforms and license, plus "how to use this document";
  • vision, goals, audience and principles;
  • decisions D-01 to D-22: the ones already in force (WinUI 3, own display and audio code, release channels, shortcuts off by default, six languages, …) and the ones still open (local API v1, Linux/macOS, per-game profiles with Tako);
  • history from the first commit to 1.7.0-alpha.2 and the state of 1.7.0;
  • the boundary with Tako, following Tako's ADR-0025;
  • stack, architecture, functional scope, interfaces, non-functional requirements;
  • a backlog by epic with IDs: everything shipped so far is marked [x] with its PR and version (CORE, LAUNCH, INPUT, UI, MENU, FILES, FPS, TV, I18N, REL, DIAG, QA, DOC); what's next is unchecked with a priority (Tako, JoyChromium, Hydra, AnyFSE, API v1 for Tako's CMI epic, Ko-fi/BuyMeACoffee, UX, code signing, Linux/macOS);
  • a MoSCoW list and an ordered checklist to close 1.7.0, acceptance criteria, risks, Definition of Done and references.

Notes

  • Docs only, no code or strings changed, so no changelog item.
  • Decisions marked "Proposta" or "A decidir", plus priorities and the performance targets in §8.4, still need the maintainer's call.
  • Hydra is described from the maintainer's summary, not checked against its site.
  • No build or tests run, since nothing under src/ or tests/ changed; CI covers it.

🤖 Generated with Claude Code

lippdev and others added 2 commits October 29, 2026 10:23
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes The Portuguese PRD documents Console Mode's product direction, shipped history, current 1.7.0 release gates, roadmap, and cross-cutting requirements and risks.

  • Product direction and history — Defines the vision, audiences, principles, and milestones through 1.7.0-alpha.2.
  • Release readiness — Records the current open PRs and the exit criteria for 1.7.0.
  • Future scope and constraints — Prioritizes launcher integrations and other roadmap work, and captures product-wide requirements, risks, and open decisions.

Pullfrog  | View workflow run | Using gpt-6-luna | 𝕏

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ No critical issues — one documentation consistency suggestion inline.

Reviewed changes Rewrote the PRD into a product requirements document with a detailed shipped-feature inventory and prioritized backlog.

  • Product direction — Added product decisions, the Tako boundary, and expanded product and architecture context.
  • Roadmap and release readiness — Reorganized shipped work and upcoming work into epics, including the 1.7.0 checklist.
  • Acceptance and quality criteria — Added measurable acceptance criteria, non-functional requirements, risks, and a Definition of Done.

Pullfrog  | Fix all ➔ | Fix 👍s ➔ | View workflow run | Using gpt-6-luna | 𝕏

Comment thread docs/PRD.md

- **Controller-first:** toda jornada principal funciona só com o controle, Xbox ou PlayStation.
- **Recovery-first:** nenhuma sessão deixa o usuário sem imagem, sem áudio ou sem caminho de volta à mesa.
Toda troca é salva em disco antes de acontecer.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This states that every session change is already saved durably, but D-22 and CORE-012 say durable recovery for icons, pointer state, and end commands is still pending. Please qualify this principle as a target or limit it to the state currently persisted, so the current guarantee matches the backlog.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ No new actionable issues found in this delta.

Reviewed changes Reviewed the PRD additions documenting dropped or reverted work and known unfixed bugs.

  • Historical record — Added the fate and repository references for earlier implementations and proposals, including the reverted Android TV support.
  • Backlog accuracy — Updated shipped launcher and TV entries to point at the implementations that remain in the product and linked the unmerged TV proposals to future backlog items.
  • Known bugs — Recorded four issues as unresolved backlog items with their current evidence and limitations.

Pullfrog  | Fix it ➔ | View workflow run | Using gpt-6-luna | 𝕏

@lippdev
lippdev merged commit 1824c53 into main Oct 29, 2026
5 checks passed
@lippdev lippdev mentioned this pull request Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant