chore: initialize .please/ workspace setup - #295
Conversation
- Add .please/ workspace scaffold with config, knowledge docs, product specs, and active tracks (improve-test-coverage) - Update .claude/settings.json: enable plugins (gh-please, please, review, github, standards, dev-tools, vue, antfu, vitest, gatekeeper, claude-code-setup, cloudflare), set env vars, add extra marketplaces - Add .please/state/ to .gitignore to exclude runtime state from version control
Summary of ChangesHello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed! This pull request establishes a foundational Highlights
🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console. Using Gemini Code AssistThe full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips. Invoking Gemini You can request assistance from Gemini at any point by creating a comment using either
Customization To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a Limitations & Feedback Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here. Footnotes
|
|
Deploy preview for express-basic-auth ready! ✅ Preview Built with commit e690e4c. |
There was a problem hiding this comment.
Pull request overview
Initializes a .please/ workspace scaffold (configuration + documentation indexes + an initial active track) and updates local Claude Code settings / repo ignores to support the workflow.
Changes:
- Add
.please/workspace structure (index, config, knowledge docs, track docs, and placeholder spec/plan/metadata for an active track). - Update
.claude/settings.jsonwith plugin enablement and environment configuration. - Ignore
.please/state/via.gitignoreto prevent runtime state from being committed.
Reviewed changes
Copilot reviewed 14 out of 15 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
.please/INDEX.md |
Adds top-level navigation for the .please/ workspace and links to key repo docs. |
.please/config.yml |
Defines .please doc path overrides and language setting. |
.please/docs/knowledge/product.md |
Adds product overview/constraints for the action. |
.please/docs/knowledge/product-guidelines.md |
Adds coding/documentation/release guidelines. |
.please/docs/knowledge/tech-stack.md |
Documents runtime/tooling dependencies and build/distribution expectations. |
.please/docs/knowledge/workflow.md |
Defines implementation workflow/TDD process and common commands. |
.please/docs/product-specs/index.md |
Adds product specs index scaffold. |
.please/docs/decisions/index.md |
Adds ADR index scaffold. |
.please/docs/tracks/index.md |
Adds tracks index and registers the initial “improve test coverage” track. |
.please/docs/tracks/tech-debt-tracker.md |
Adds a tech-debt tracking table scaffold. |
.please/docs/tracks/active/improve-test-coverage-20260326/metadata.json |
Adds track metadata scaffold. |
.please/docs/tracks/active/improve-test-coverage-20260326/plan.md |
Adds plan placeholder scaffold. |
.please/docs/tracks/active/improve-test-coverage-20260326/spec.md |
Adds the initial track spec content for improving test coverage. |
.claude/settings.json |
Enables plugins and sets Claude Code environment values/marketplaces. |
.gitignore |
Adds .please/state/ ignore rule (and normalizes .next entry formatting). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new project structure and extensive documentation under the .please/ directory, integrating a "please plugin" for managing project artifacts, workflows, and documentation related to a "Vercel Action". Key additions include an index for project documents, a directory map, configuration, workflow definitions, and detailed guides on product, tech stack, and development workflow. It also updates .claude/settings.json to replace the old permissions structure with new environment variables and enabled plugins. Review comments suggest improving the .claude/settings.json by changing string-represented numerical values to actual integers for CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS and CLAUDE_CODE_DISABLE_AUTO_MEMORY. Additionally, the created_at and updated_at fields in .please/docs/tracks/active/improve-test-coverage-20260326/metadata.json are noted to be set to a future date and should be updated to reflect current or actual dates.
|
Summary
.please/workspace scaffold with configuration, knowledge docs, product specs, and an active development track.claude/settings.jsonto enable plugins and configure environment variables for Claude Code.please/state/to.gitignoreto prevent runtime state from being committedChanges
.please/INDEX.md— top-level workspace index.please/config.yml— workspace configuration.please/docs/knowledge/— product guidelines, tech stack, and workflow documentation.please/docs/product-specs/— product specification index.please/docs/decisions/— architecture decision records index.please/docs/tracks/— development track index, tech debt tracker, and active trackimprove-test-coverage-20260326(metadata, plan, spec).claude/settings.json— enabled plugins:gh-please,please,review,github,standards,dev-tools,vue,antfu,claude-md-management,vitest,gatekeeper,claude-code-setup,cloudflare; setENABLE_TOOL_SEARCH,CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS,CLAUDE_CODE_DISABLE_AUTO_MEMORY; addedpassionfactoryandpleaseaiextra marketplaces.gitignore— added.please/state/exclusion ruleTest Plan
.please/directory is tracked (excludingstate/)example/nextjs/productionpwas NOT included in this PR.please/state/is covered by.gitignore