jobtrackingapp/.gsd/REQUIREMENTS.md

Requirements

This file is the explicit capability and coverage contract for the project.

Active

R004 — The app must generate follow-up and reply drafts from the imported job, saved application material, and correspondence context tied to that job.

• Class: primary-user-loop
• Status: active
• Description: The app must generate follow-up and reply drafts from the imported job, saved application material, and correspondence context tied to that job.
• Why it matters: Follow-through is part of the core value, not an optional afterthought.
• Source: user
• Primary owning slice: M001/S03
• Supporting slices: M001/S01, M001/S02, M001/S05
• Validation: mapped
• Notes: The user stays in control of sending; the app provides strong drafts only.

R005 — The first page should give the user a clear overview of jobs, status, readiness, and what needs attention.

• Class: continuity
• Status: active
• Description: The first page should give the user a clear overview of jobs, status, readiness, and what needs attention.
• Why it matters: The user explicitly wants to start from the job table each day.
• Source: user
• Primary owning slice: M001/S04
• Supporting slices: M001/S05
• Validation: mapped
• Notes: This should feel like “scan the field” before drilling into one job.

R006 — The dashboard and follow-up surfaces must clearly show next actions, neglected threads, and jobs that need attention now.

• Class: continuity
• Status: active
• Description: The dashboard and follow-up surfaces must clearly show next actions, neglected threads, and jobs that need attention now.
• Why it matters: Tracking is only valuable if it turns state into action.
• Source: user
• Primary owning slice: M001/S04
• Supporting slices: M001/S05
• Validation: mapped
• Notes: The follow-up/dashboard view is the second navigation priority after the table.

R007 — Each job needs a workspace where the user can update status, review/import correspondence, edit drafts, and prepare follow-ups.

• Class: core-capability
• Status: active
• Description: Each job needs a workspace where the user can update status, review/import correspondence, edit drafts, and prepare follow-ups.
• Why it matters: The user’s third step in the daily flow is to drop into a specific job and do focused work.
• Source: inferred
• Primary owning slice: M001/S03
• Supporting slices: M001/S02, M001/S04
• Validation: mapped
• Notes: This is where the product should feel connected instead of scattered.

R008 — The app may draft application, reply, and follow-up content, but it must not auto-send emails or auto-apply to jobs.

• Class: constraint
• Status: active
• Description: The app may draft application, reply, and follow-up content, but it must not auto-send emails or auto-apply to jobs.
• Why it matters: The user called auto-sending dangerous and explicitly does not want that behavior.
• Source: user
• Primary owning slice: M001/S03
• Supporting slices: M001/S05
• Validation: mapped
• Notes: This is a durable trust constraint across all milestones.

R009 — Core UX, data model emphasis, and roadmap decisions should optimize for one person managing their own search.

• Class: constraint
• Status: active
• Description: Core UX, data model emphasis, and roadmap decisions should optimize for one person managing their own search.
• Why it matters: Individual-first scope keeps product decisions sharp and prevents premature recruiter/CRM drift.
• Source: user
• Primary owning slice: M001/S04
• Supporting slices: M002/S01, M004/S01
• Validation: mapped
• Notes: Shared/team workflows are not the current product target.

R010 — The app must preserve a coherent history across manual status changes, imported Gmail correspondence, reminders, and follow-up work.

• Class: continuity
• Status: active
• Description: The app must preserve a coherent history across manual status changes, imported Gmail correspondence, reminders, and follow-up work.
• Why it matters: The product promise is to keep the thread of the job search intact over time.
• Source: user
• Primary owning slice: M001/S04
• Supporting slices: M001/S01, M001/S03, M001/S05
• Validation: mapped
• Notes: This is part of what makes the app a tracker and follow-up system, not just a draft generator.

Validated

R001 — The user finds a job outside the app, imports it into the app, and starts the application workflow from that imported role.

• Class: primary-user-loop
• Status: validated
• Description: The user finds a job outside the app, imports it into the app, and starts the application workflow from that imported role.
• Why it matters: The product is not a job board replacement; the import step is the real start of the user loop.
• Source: user
• Primary owning slice: M001/S01
• Supporting slices: M001/S05
• Validation: S01 completed with a job-scoped Gmail import loop wired into the job workspace: backend GET /api/gmail/job-candidates uses the owned job as context, imports target that job directly, and focused UI verification passed in job-tracker-ui/src/correspondence-gmail-import.test.tsx.
• Notes: Validation is contract/UI-level plus workspace integration. Live user UAT of the broader milestone loop still remains for later slices.

R002 — Gmail connection, message retrieval, and message/thread import must help the user pull real correspondence into the right job with materially less manual cleanup.

• Class: integration
• Status: validated
• Description: Gmail connection, message retrieval, and message/thread import must help the user pull real correspondence into the right job with materially less manual cleanup.
• Why it matters: Gmail import is one of the two clearest current weaknesses and a major trust surface for daily use.
• Source: user
• Primary owning slice: M001/S01
• Supporting slices: M001/S03, M001/S05
• Validation: S01 completed with backend-ranked job-aware Gmail candidates, explicit imported/skipped import payloads, persisted thread/sender/recipient metadata, and focused verification across isolated GmailControllerTests plus CI=true npm --prefix job-tracker-ui test -- --watch=false --runTestsByPath src/correspondence-gmail-import.test.tsx.
• Notes: The broader JobTrackerApi.Tests project still has unrelated compile drift, so Gmail backend coverage was isolated instead of run through the full test project. Live Gmail UAT is still needed to judge trust on a real inbox.

R003 — Tailored CV and cover-letter drafts must feel specific, credible, and good enough that the user wants to start from them.

• Class: differentiator
• Status: validated
• Description: Tailored CV and cover-letter drafts must feel specific, credible, and good enough that the user wants to start from them.
• Why it matters: Draft generation exists already, but the milestone bar is actual usefulness rather than feature presence.
• Source: user
• Primary owning slice: M001/S02
• Supporting slices: M001/S05
• Validation: Validated by M001/S02: backend application-package generation now uses recruiter/job/profile/attachment/imported-correspondence context, focused backend tests pass in an isolated harness, and the Tailored CV workspace test proves generation, editing, save, and saved-state redisplay behavior.
• Notes: S02 proved the application-package drafts are materially more specific and persist as job-tied working material. Broader end-to-end live-loop revalidation still remains in M001/S05.

Deferred

R011 — The app should later expand overview analytics, saved views, and clearer strategy readouts beyond the core daily loop.

• Class: operability
• Status: deferred
• Description: The app should later expand overview analytics, saved views, and clearer strategy readouts beyond the core daily loop.
• Why it matters: This can improve search strategy, but it is not the first trust gap to close.
• Source: inferred
• Primary owning slice: M002/S02
• Supporting slices: none
• Validation: unmapped
• Notes: Deferred because Gmail import and draft quality are higher-value first fixes.

R012 — The product may later add richer message understanding, smarter thread handling, and broader inbox-aware assistance after the first Gmail milestone.

• Class: integration
• Status: deferred
• Description: The product may later add richer message understanding, smarter thread handling, and broader inbox-aware assistance after the first Gmail milestone.
• Why it matters: This extends the correspondence workflow, but it depends on getting the initial import/matching loop right first.
• Source: inferred
• Primary owning slice: M003/S01
• Supporting slices: none
• Validation: unmapped
• Notes: This is the natural next step after M001 proves the core Gmail path.

R013 — The app may later add broader strategic coaching and more advanced guidance beyond application package and follow-up/reply drafting.

• Class: differentiator
• Status: deferred
• Description: The app may later add broader strategic coaching and more advanced guidance beyond application package and follow-up/reply drafting.
• Why it matters: There is room to deepen the assistant, but the current product bar is a stronger core workflow.
• Source: inferred
• Primary owning slice: M003/S02
• Supporting slices: none
• Validation: unmapped
• Notes: Deferred to avoid scattering the first milestone.

Out of Scope

R014 — The app will not automatically submit applications to external job sites.

• Class: anti-feature
• Status: out-of-scope
• Description: The app will not automatically submit applications to external job sites.
• Why it matters: This prevents product drift into risky, low-trust automation the user explicitly does not want.
• Source: user
• Primary owning slice: none
• Supporting slices: none
• Validation: n/a
• Notes: The app starts after discovery/import, not at job search submission.

R015 — The app will not send replies, follow-ups, or other communication autonomously.

• Class: anti-feature
• Status: out-of-scope
• Description: The app will not send replies, follow-ups, or other communication autonomously.
• Why it matters: Manual control over outbound communication is a hard trust requirement.
• Source: user
• Primary owning slice: none
• Supporting slices: none
• Validation: n/a
• Notes: Drafting is allowed; autonomous sending is not.

R016 — The product will not optimize for shared pipelines, recruiter operations, or multi-user coaching workflows right now.

• Class: out-of-scope
• Status: out-of-scope
• Description: The product will not optimize for shared pipelines, recruiter operations, or multi-user coaching workflows right now.
• Why it matters: This protects the individual-first product shape.
• Source: user
• Primary owning slice: none
• Supporting slices: none
• Validation: n/a
• Notes: Multi-user admin surfaces may exist technically, but they are not the roadmap center.

R017 — The app will not try to replace external job boards as the main discovery surface.

• Class: out-of-scope
• Status: out-of-scope
• Description: The app will not try to replace external job boards as the main discovery surface.
• Why it matters: The user explicitly described a workflow that starts after finding the job elsewhere.
• Source: user
• Primary owning slice: none
• Supporting slices: none
• Validation: n/a
• Notes: Job import is the bridge from external discovery into the app.

Traceability

ID	Class	Status	Primary owner	Supporting	Proof
R001	primary-user-loop	validated	M001/S01	M001/S05	S01 completed with a job-scoped Gmail import loop wired into the job workspace: backend GET /api/gmail/job-candidates uses the owned job as context, imports target that job directly, and focused UI verification passed in job-tracker-ui/src/correspondence-gmail-import.test.tsx.
R002	integration	validated	M001/S01	M001/S03, M001/S05	S01 completed with backend-ranked job-aware Gmail candidates, explicit imported/skipped import payloads, persisted thread/sender/recipient metadata, and focused verification across isolated GmailControllerTests plus CI=true npm --prefix job-tracker-ui test -- --watch=false --runTestsByPath src/correspondence-gmail-import.test.tsx.
R003	differentiator	validated	M001/S02	M001/S05	Validated by M001/S02: backend application-package generation now uses recruiter/job/profile/attachment/imported-correspondence context, focused backend tests pass in an isolated harness, and the Tailored CV workspace test proves generation, editing, save, and saved-state redisplay behavior.
R004	primary-user-loop	active	M001/S03	M001/S01, M001/S02, M001/S05	mapped
R005	continuity	active	M001/S04	M001/S05	mapped
R006	continuity	active	M001/S04	M001/S05	mapped
R007	core-capability	active	M001/S03	M001/S02, M001/S04	mapped
R008	constraint	active	M001/S03	M001/S05	mapped
R009	constraint	active	M001/S04	M002/S01, M004/S01	mapped
R010	continuity	active	M001/S04	M001/S01, M001/S03, M001/S05	mapped
R011	operability	deferred	M002/S02	none	unmapped
R012	integration	deferred	M003/S01	none	unmapped
R013	differentiator	deferred	M003/S02	none	unmapped
R014	anti-feature	out-of-scope	none	none	n/a
R015	anti-feature	out-of-scope	none	none	n/a
R016	out-of-scope	out-of-scope	none	none	n/a
R017	out-of-scope	out-of-scope	none	none	n/a

Coverage Summary

• Active requirements: 7
• Mapped to slices: 7
• Validated: 3 (R001, R002, R003)
• Unmapped active requirements: 0