Rhythm 2.0 Specifications

Appearance

CAP-PFM-LLM-019Use Jazz AI conversations and project folders

Markdown

CAP-PFM-LLM-019

Use Jazz AI conversations and project folders

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationPartially observed

Planning

Feature
FEAT-PFM-LLM-07
Exercised by
FAS-PFM-LLM-07-01, FAS-PFM-LLM-07-02, FAS-PFM-LLM-07-03, FAS-PFM-LLM-07-04, FAS-PFM-LLM-07-05
Key concepts
CON-PFM-LLM-005
Actors
ACT-PFM-032
Journeys
JNY-PFM-LLM-005
Related
CAP-PFM-LLM-001, CAP-PFM-LLM-020
Open questions
OQ-PFM-LLM-003
Proved by
ATS-PFM-LLM-019

KindCapabilityProduct areaPlatformModuleAI Requests, Usage and the Jazz AI TeammateRevision1

Read atreact-console baf6dae3services-platform ad3f6a65

Use Jazz AI conversations and project folders ​

Purpose ​

Let staff discuss work with the teammate and organize that conversation history.

How It Works ​

Staff open Jazz AI from its full page or the console header. They can start a general conversation or place it in a project that supplies context for replies. The console currently calls its own model route for general answers rather than Platform’s metered runtime. A successful reply appends both sides of the exchange. A failed reply restores the person’s draft so they can retry. Staff can rename, archive, restore or delete conversations and manage their project folders. The current store uses shared server memory and a sample owner, so these controls do not establish customer privacy or durable history. The product should replace that prototype boundary before exposing real customer conversations.

Relationships ​

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
The prototype offers drafting and planning conversations.Conversations support search, projects, renaming, archive, restore and deletion.
Surfaces
console
Preconditions
The person has entered the console.
Constraints
Jazz AI remains a console prototype with unresolved isolation, persistence and metering.

Controls

35 controls apply, from the corpus control catalogue.

TC-AI-001 TC-AI-004 TC-AI-006 TC-AI-007 TC-AVL-001 TC-AVL-004 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-CRY-001 TC-CRY-002 TC-CRY-003 TC-CRY-004 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-DAT-004 TC-LOG-002 TC-LOG-003 TC-LOG-005 TC-MON-001 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Business Rules

12 rules, 7 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

IdRuleKindEnforced atProvenance
01must prove
Proposed
Signed-in staff can open Jazz AI from its page or header panel without an AI permission check or an organization AI-switch check.
proved by ATS-PFM-LLM-019-01
permissionconsoleobserved
react-console:components/console/nav-config.ts:unlistedNav
02must prove
Proposed
General Jazz AI replies use a console-side model call without Platform request accounting, allowance holds, evidence capture or organization AI-switch enforcement.
proved by ATS-PFM-LLM-001-19, ATS-PFM-LLM-019-02
policyconsoleobserved
react-console:app/api/agent/conversations/[id]/messages/route.ts:MODEL
03
Proposed
General replies use thirty previous messages plus the new question and an instruction containing the configured organization and project context, requesting concise answers without invented record facts and directing lists to Queries.
policyconsoleobserved
react-console:app/api/agent/conversations/[id]/messages/route.ts:systemPrompt
04
Proposed
Reply failure presents a retry message and restores the submitted question in the composer.
policyconsoleobserved
react-console:components/console/agent-chat.tsx:send
05must prove
Proposed
Direct questions allow one to four thousand trimmed characters, appended turns up to eight thousand, project names one to eighty and descriptions up to four hundred; titles allow up to one hundred and twenty and a new title may be empty.
proved by ATS-PFM-LLM-019-03
validationconsoleobserved
react-console:lib/agent/schemas.ts
06
Proposed
A new conversation uses the default title until its first user message supplies a whitespace-normalized sixty-character title, which staff can later rename.
lifecycleconsoleobserved
react-console:lib/agent/store.ts:appendMessages
07must prove
Proposed
Conversation and project access filters a fixed sample owner in shared server memory, creating neither actual user nor workspace isolation and losing updates on restart.
proved by ATS-PFM-LLM-019-04
invariantconsoleobserved
react-console:lib/agent/store.ts:owned
08must prove
Proposed
Projects support creation, naming, description and deletion; deleting a project retains its conversations as unfiled, and project lists sort by name with unarchived conversation counts.
proved by ATS-PFM-LLM-019-05
lifecycleconsoleobserved
react-console:lib/agent/store.ts:deleteProject
09must prove
Proposed
Archive retains a restorable conversation outside active lists and archiving the open conversation starts another conversation.
proved by ATS-PFM-LLM-019-06, ATS-PFM-LLM-019-08
lifecycleconsoleobserved
react-console:components/agent/conversation-browser.tsx:onArchive
10must prove
Proposed
Conversation and project deletion require confirmation and permanently remove the selected object.
proved by ATS-PFM-LLM-019-07
lifecycleconsoleobserved
react-console:components/agent/conversation-browser.tsx
11
Proposed
Conversation search matches titles or message text without case sensitivity within the selected unarchived list and orders results by recent activity.
policyconsoleobserved
react-console:lib/agent/store.ts:listConversations
12
Proposed
The conversation client writes through console agent routes rather than forwarding conversation writes to Platform’s query client.
invariantconsoletest
react-console:lib/agent/__tests__/client.test.ts#never routes through the query client

Scenarios

IdGivenWhenThenProvenance
01A person creates a project and starts a conversation.They later search for words used in its title.The store can return that conversation and its project association.inferred
react-console:lib/agent/store.ts

Edge Cases

IdGivenWhenThenProvenance
02A conversation belongs to a query scope.A general-reply request targets that conversation.The route directs the person to continue from the query.observed
react-console:app/api/agent/conversations/[id]/messages/route.ts (409 Open the query to continue this conversation)

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software