Skip to content

Conversation

amittell
Copy link

@amittell amittell commented Jul 2, 2025

Merged useful PRs #2 and #3 to make them easier to merge into main

ulasbilgen and others added 12 commits June 28, 2025 23:19
- Implement Node.js TypeScript MCP server with 6 tools
- Add npm package configuration for distribution
- Include built files for direct GitHub installation
- Update documentation with dual installation options
- Maintain backward compatibility with slash commands

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Remove complex GitHub direct install instructions
- Emphasize npm package installation as primary method
- Simplify user experience with working npm package

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- No longer needed since using regular npm registry
- Cleanup for cleaner repository

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>
- Add settings configuration for discovery and expert question counts (1-20 range)
- Implement MCP elicitation for interactive boolean questions with default handling
- Add requirements-settings tool to manage question counts
- Update requirements-start to use configurable settings
- Rewrite requirements-status with elicitation workflow
- Add question pool system with smart defaults and reasoning
- Store settings in requirements/.mcp-settings.json
- Fix default handling for "press Enter" behavior in MCP clients
- Version bump to 1.1.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Simplified requirements-settings tool to be parameter-free
- Shows current values and asks for each setting separately
- Uses MCP elicitation with current values as defaults
- Press Enter to keep existing values, or type new number
- Clear feedback showing what changed vs unchanged
- Better range validation (1-20) with helpful descriptions
- Version bump to 1.2.0

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Ensure requirements directory exists in loadSettings() before reading
- Fixes issue where settings command fails on fresh projects
- Version bump to 1.2.1

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
- Add new /synthesize command that transforms completed requirements into implementation
- Command finds most recent completed requirement automatically in requirements/ directory
- Generates phased implementation plan with tracked todo list
- Maps tasks to specific requirement IDs (FR/TR)
- Begins actual implementation with progress tracking
- Works from current working directory like other requirements commands
- Update README.md with new command documentation

Co-Authored-By: Claude <[email protected]>
- Added complete MCP server implementation from PR rizethereum#2
- Added /synthesize command from PR rizethereum#3
- Resolved README.md conflicts by combining both features
- Updated package.json URLs for forked repository
- All functionality tested and working
@Copilot Copilot AI review requested due to automatic review settings July 2, 2025 22:01
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR merges the changes from PR#2 and PR#3 to provide a unified requirements-gathering workflow via both MCP server tools and slash commands.

  • Integrates interactive settings persistence and a full suite of MCP tools for requirements start/status/current/end/list/remind/settings
  • Introduces a new synthesize slash-command spec for turning completed requirements into implementation plans
  • Updates package metadata, installation docs, and ignores non-dist files for npm

Reviewed Changes

Copilot reviewed 6 out of 13 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/index.ts Implements MCP server tools for requirements workflow (start, status, current, end, list, remind, settings)
package.json Bumps version to 1.2.1; updates scripts, bin entry, dependencies, and repository URL
commands/synthesize.md Adds spec for /synthesize slash command to generate implementation plan and todo
README.md Expands Quick Start with MCP server & synthesize instructions; updates clone URL
CLAUDE.md Documents project structure and workflow; needs update to include requirements-settings
.npmignore Excludes source, commands, docs, and other non-dist files from published package
Comments suppressed due to low confidence (5)

commands/synthesize.md:17

  • The documented timestamp format (YYYY-MM-DD_HH-MM-SS_*) doesn't match createTimestampFolder output (YYYY-MM-DD-HHMM). Consider updating the docs or the code to align the timestamp conventions.
   - Look for subdirectories with timestamp format (YYYY-MM-DD_HH-MM-SS_*)

README.md:29

  • The clone URL in the README points to ulasbilgen but package.json and other references use amittell. Ensure the repository URL is correct and consistent.
```json

src/index.ts:1

  • This PR adds extensive new server logic without accompanying tests. Consider adding unit or integration tests for core workflows (requirements-start, requirements-status, requirements-end, etc.).
#!/usr/bin/env node

CLAUDE.md:44

  • The docs list six MCP tools but the code also registers requirements-settings. Update CLAUDE.md to include this new tool so documentation stays in sync with the code.
  - `requirements-remind` - Workflow rules and best practices reminder

src/index.ts:318

  • [nitpick] The inline expertQuestions array is duplicated in the discovery/detail logic. Extract this into a shared constant or generator function to avoid duplication and simplify future updates.
        const expertQuestions = [

@dwenaus
Copy link

dwenaus commented Jul 6, 2025

looks like a great addition. How are you using the MCP server day-to-day? The slash commands are for humans, how is claude using the mcp server in your case? @amittell @adamflagg is the idea with the mcp tools, that you can no just ask claude: "what is the status of requirements"?

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.

4 participants