Skip to content

feat(ai-project-generator): conditional sprints, UX platform awareness & priority fix#201

Closed
parth0025 wants to merge 5 commits into
stagingfrom
feat/ai-project-plan-conditional-sprints
Closed

feat(ai-project-generator): conditional sprints, UX platform awareness & priority fix#201
parth0025 wants to merge 5 commits into
stagingfrom
feat/ai-project-plan-conditional-sprints

Conversation

@parth0025
Copy link
Copy Markdown
Collaborator

Summary

  • Conditional sprint additions — three new sprint/task groups injected into the AI plan prompt; each is skipped automatically when its condition is not met
  • UX design platform awareness — clarify step asks which design tool the team uses; plan generates a platform-specific setup task with step-by-step instructions
  • Priority fix — removed Urgent, enforced Low / Medium / High only (company defaults), added distribution-check rule to stop the model over-assigning High

Changes

prompts/project-plan/special-sprints-guidance.md (new file)

New prompt partial wired between sprint-guidance.md and task-guidance.md:

Addition Condition What's generated
GitHub & Version Control Setup Source code or multi-dev 8 step-by-step tasks: account/org, repo, SSH/HTTPS auth, branching strategy, commit & PR conventions, branch protection, semantic versioning + changelogs
Environment & Tech-Stack Setup Any tech item needing install/config One task per qualifying item (DB, backend, cloud, design platform) with install → configure → verify steps
Test Case Guidelines 2+ testable modules 4 tasks: what test cases are, how to write them, module-wise structure, QA tracking workflow

prompts/clarify/system.md

  • Added Design platform to the "Always ask when" list — triggered whenever the project involves screens, wireframes, or prototyping
  • Added Design platform row to the Product dimension scan table
  • Options: Figma (recommended), Adobe XD, Penpot, Framer, Sketch, Balsamiq, Miro, Let AI decide

prompts/project-plan/special-sprints-guidance.md — design platform sub-section

  • Per-platform setup task instructions: Figma (incl. MCP server setup with Claude), Penpot, Adobe XD, Framer, Sketch, Balsamiq, Miro
  • Fixed: design tools were wrongly in the "skip these" list — they now correctly qualify

prompts/project-plan/task-guidance.md

  • Removed Urgent — only Low / Medium / High are valid
  • Added clear definitions tied to actual blocking behaviour
  • Added required distribution check: expected ~1–2 High, 4–6 Medium, 1–2 Low per sprint; model must downgrade if >1/3 are High

prompts/project-plan/schema.md

  • "priority" enum: "Low" | "Medium" | "High" (Urgent removed)

Modules/AIProjectGenerator/orchestrator.js

  • PRIORITY_NORMALIZE map: removed urgent: 'URGENT'; any stale value falls back to 'MEDIUM'

Test plan

  • Generate a plan for a software project → verify GitHub sprint appears first, tech-stack setup sprint second, test case sprint third
  • Generate a plan for a podcast/content project → verify none of the three conditional sprints appear
  • Run clarify step for a project with screens → verify design platform question appears
  • Generate a plan with Figma selected → verify Figma MCP setup task is present in the setup sprint
  • Inspect generated task priorities → verify no Urgent values, High used sparingly

🤖 Generated with Claude Code

parth0025 and others added 5 commits May 27, 2026 19:02
Add a filter-driven dashboard card showing per-employee planned,
logged, and estimated hours for a chosen period, with expandable
per-task breakdowns, totals footer, client-side sorting, employee
search, and over-budget highlighting.

- Backend: getEmployeeWorkloadReport endpoint + route. Period pivots
  on estimated_time.Date (planned) and timesheets.LogStartTime
  (logged); multi-assignee aware. Role-based visibility aligned with
  the app-wide convention (roleType 1/2 see all filtered employees,
  others see only themselves). Returns all matching tasks per
  employee (no display cap).
- Frontend: EmployeeWorkloadReportCard widget + sticky-header table,
  Wasabi-backed avatars via the users store, subtask indicator,
  team->user resolution, role-aware Edit Card fields.
- Config: cardComponent.json catalog entry, i18n keys, default grid
  size, HomePage getComponent case.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…s, and priority fix

== 1. Conditional sprint additions (promptBuilder.js + special-sprints-guidance.md) ==

New prompt partial injected between sprint-guidance and task-guidance:

- GitHub & Version Control Setup sprint (first sprint when source code or
  multi-dev is detected): 8 step-by-step tasks covering account/org setup,
  repo creation, SSH/HTTPS auth, branching strategy, commit conventions,
  PR conventions, branch protection, semantic versioning + changelogs.

- Environment & Tech-Stack Setup sprint (one task per qualifying tech item):
  databases, backend frameworks, cloud services. Each task covers install,
  configure, create instance/DB, verify connection.

- Test Case Guidelines sprint (when project has 2+ testable modules):
  4 tasks covering what test cases are, how to write them, module-wise
  structure mapped to the project's own modules, and QA tracking workflow.

All three are conditional — omitted when the condition is not met.

== 2. UX design platform awareness (clarify/system.md + special-sprints-guidance.md) ==

Clarify step now asks which design/UX tool the team will use whenever
the project involves screen design or wireframing. Options: Figma,
Adobe XD, Penpot (open-source), Framer (code-based), Sketch (macOS),
Balsamiq (low-fidelity), Miro, Let AI decide.

Plan generation emits a platform-specific setup task for the chosen
tool, including Figma MCP server setup (token generation, npx install,
config JSON, benefits for design-to-code handoff with AI assistants).

Fixed: design tools were wrongly listed in the skip list for tech-stack
setup — they now correctly qualify as setup items.

== 3. Priority fix (task-guidance.md + schema.md + orchestrator.js) ==

- Removed Urgent entirely. Only Low / Medium / High are valid — these
  are the three default priority values in every AlianHub installation.
- Added required distribution check: if >1/3 of tasks are High the model
  must go back and downgrade; expected ratio is ~1-2 High, 4-6 Medium,
  1-2 Low per sprint.
- schema.md enum updated: "Low" | "Medium" | "High" (no Urgent).
- orchestrator.js PRIORITY_NORMALIZE map drops urgent; any stale value
  falls through to the MEDIUM default.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@parth0025
Copy link
Copy Markdown
Collaborator Author

Closing — replaced by a clean branch without unrelated file history. New PR incoming.

@parth0025 parth0025 closed this Jun 1, 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