feat: add action-required.md to /create-feature command
Extends the /create-feature command to generate a third file that extracts manual/human tasks into a dedicated checklist for better visibility. Changes: - Add step 4 to create action-required.md with manual tasks - Add template format with Before/During/After Implementation sections - Add "no manual steps" template variant - Update Next Steps to prioritize reviewing action-required.md - Add note listing common manual task types (API keys, env vars, etc.) - Bump create-agentic-app version to 1.1.27 Manual tasks (like account creation, environment variables, OAuth setup) are now surfaced in a separate file so they're harder to miss during feature implementation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -26,7 +26,14 @@ This command creates a new feature specification folder with requirements and im
|
|||||||
- Tasks should be specific enough for an agent to implement independently
|
- Tasks should be specific enough for an agent to implement independently
|
||||||
- Include dependencies between tasks where relevant
|
- Include dependencies between tasks where relevant
|
||||||
|
|
||||||
4. **Exclude testing tasks**
|
4. **Create action-required.md**
|
||||||
|
- Extract all manual steps that require human action
|
||||||
|
- Include tasks like: account creation, API key setup, environment variables, third-party service configuration, DNS settings, etc.
|
||||||
|
- Each task has a checkbox and brief context (one-liner explaining why it's needed)
|
||||||
|
- Keep these tasks in the implementation plan as well (for full context)
|
||||||
|
- If no manual steps exist, create the file with a "None required" note
|
||||||
|
|
||||||
|
5. **Exclude testing tasks**
|
||||||
- Do NOT include unit or e2e testing tasks
|
- Do NOT include unit or e2e testing tasks
|
||||||
- UNLESS the user explicitly asks for testing to be included
|
- UNLESS the user explicitly asks for testing to be included
|
||||||
|
|
||||||
@@ -36,6 +43,7 @@ Ask the user what the requirements are first, then create the spec subfolder wit
|
|||||||
|
|
||||||
- `requirements.md`
|
- `requirements.md`
|
||||||
- `implementation-plan.md`
|
- `implementation-plan.md`
|
||||||
|
- `action-required.md`
|
||||||
|
|
||||||
## Implementation Plan Format
|
## Implementation Plan Format
|
||||||
|
|
||||||
@@ -69,6 +77,44 @@ Brief summary of what will be built.
|
|||||||
...
|
...
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## action-required.md Format
|
||||||
|
|
||||||
|
Use this structure for `action-required.md`:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Action Required: {Feature Name}
|
||||||
|
|
||||||
|
Manual steps that must be completed by a human. These cannot be automated.
|
||||||
|
|
||||||
|
## Before Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason why this is needed}
|
||||||
|
|
||||||
|
## During Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason}
|
||||||
|
|
||||||
|
## After Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> **Note:** These tasks are also listed in context within `implementation-plan.md`
|
||||||
|
```
|
||||||
|
|
||||||
|
### When No Manual Steps Exist
|
||||||
|
|
||||||
|
If the feature has no manual steps, create the file with:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Action Required: {Feature Name}
|
||||||
|
|
||||||
|
No manual steps required for this feature.
|
||||||
|
|
||||||
|
All tasks can be implemented automatically.
|
||||||
|
```
|
||||||
|
|
||||||
## Next Steps
|
## Next Steps
|
||||||
|
|
||||||
After creating the feature, inform the user:
|
After creating the feature, inform the user:
|
||||||
@@ -77,9 +123,10 @@ After creating the feature, inform the user:
|
|||||||
>
|
>
|
||||||
> **Next steps:**
|
> **Next steps:**
|
||||||
>
|
>
|
||||||
> 1. Review the requirements and implementation plan
|
> 1. Review `action-required.md` for tasks you need to complete manually
|
||||||
> 2. Run `/publish-to-github` to create GitHub issues and project
|
> 2. Review the requirements and implementation plan
|
||||||
> 3. Use `/continue-feature` or drag the folder into a conversation to start implementing
|
> 3. Run `/publish-to-github` to create GitHub issues and project
|
||||||
|
> 4. Use `/continue-feature` to start implementing
|
||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
|
|
||||||
@@ -87,3 +134,4 @@ After creating the feature, inform the user:
|
|||||||
- Tasks should produce working, testable code when complete
|
- Tasks should produce working, testable code when complete
|
||||||
- Use clear, descriptive task names that explain what will be done
|
- Use clear, descriptive task names that explain what will be done
|
||||||
- Note dependencies explicitly when tasks must be done in order
|
- Note dependencies explicitly when tasks must be done in order
|
||||||
|
- Common manual tasks: account creation, API key generation, environment variables, OAuth app configuration, DNS/domain setup, billing setup, third-party service registration
|
||||||
|
|||||||
4
create-agentic-app/package-lock.json
generated
4
create-agentic-app/package-lock.json
generated
@@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "create-agentic-app",
|
"name": "create-agentic-app",
|
||||||
"version": "1.1.26",
|
"version": "1.1.27",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
"": {
|
"": {
|
||||||
"name": "create-agentic-app",
|
"name": "create-agentic-app",
|
||||||
"version": "1.1.26",
|
"version": "1.1.27",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"chalk": "^5.3.0",
|
"chalk": "^5.3.0",
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "create-agentic-app",
|
"name": "create-agentic-app",
|
||||||
"version": "1.1.26",
|
"version": "1.1.27",
|
||||||
"description": "Scaffold a new agentic AI application with Next.js, Better Auth, and AI SDK",
|
"description": "Scaffold a new agentic AI application with Next.js, Better Auth, and AI SDK",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"bin": {
|
"bin": {
|
||||||
|
|||||||
@@ -26,7 +26,14 @@ This command creates a new feature specification folder with requirements and im
|
|||||||
- Tasks should be specific enough for an agent to implement independently
|
- Tasks should be specific enough for an agent to implement independently
|
||||||
- Include dependencies between tasks where relevant
|
- Include dependencies between tasks where relevant
|
||||||
|
|
||||||
4. **Exclude testing tasks**
|
4. **Create action-required.md**
|
||||||
|
- Extract all manual steps that require human action
|
||||||
|
- Include tasks like: account creation, API key setup, environment variables, third-party service configuration, DNS settings, etc.
|
||||||
|
- Each task has a checkbox and brief context (one-liner explaining why it's needed)
|
||||||
|
- Keep these tasks in the implementation plan as well (for full context)
|
||||||
|
- If no manual steps exist, create the file with a "None required" note
|
||||||
|
|
||||||
|
5. **Exclude testing tasks**
|
||||||
- Do NOT include unit or e2e testing tasks
|
- Do NOT include unit or e2e testing tasks
|
||||||
- UNLESS the user explicitly asks for testing to be included
|
- UNLESS the user explicitly asks for testing to be included
|
||||||
|
|
||||||
@@ -36,6 +43,7 @@ Ask the user what the requirements are first, then create the spec subfolder wit
|
|||||||
|
|
||||||
- `requirements.md`
|
- `requirements.md`
|
||||||
- `implementation-plan.md`
|
- `implementation-plan.md`
|
||||||
|
- `action-required.md`
|
||||||
|
|
||||||
## Implementation Plan Format
|
## Implementation Plan Format
|
||||||
|
|
||||||
@@ -69,6 +77,44 @@ Brief summary of what will be built.
|
|||||||
...
|
...
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## action-required.md Format
|
||||||
|
|
||||||
|
Use this structure for `action-required.md`:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Action Required: {Feature Name}
|
||||||
|
|
||||||
|
Manual steps that must be completed by a human. These cannot be automated.
|
||||||
|
|
||||||
|
## Before Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason why this is needed}
|
||||||
|
|
||||||
|
## During Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason}
|
||||||
|
|
||||||
|
## After Implementation
|
||||||
|
|
||||||
|
- [ ] **{Action}** - {Brief reason}
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
> **Note:** These tasks are also listed in context within `implementation-plan.md`
|
||||||
|
```
|
||||||
|
|
||||||
|
### When No Manual Steps Exist
|
||||||
|
|
||||||
|
If the feature has no manual steps, create the file with:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Action Required: {Feature Name}
|
||||||
|
|
||||||
|
No manual steps required for this feature.
|
||||||
|
|
||||||
|
All tasks can be implemented automatically.
|
||||||
|
```
|
||||||
|
|
||||||
## Next Steps
|
## Next Steps
|
||||||
|
|
||||||
After creating the feature, inform the user:
|
After creating the feature, inform the user:
|
||||||
@@ -77,9 +123,10 @@ After creating the feature, inform the user:
|
|||||||
>
|
>
|
||||||
> **Next steps:**
|
> **Next steps:**
|
||||||
>
|
>
|
||||||
> 1. Review the requirements and implementation plan
|
> 1. Review `action-required.md` for tasks you need to complete manually
|
||||||
> 2. Run `/publish-to-github` to create GitHub issues and project
|
> 2. Review the requirements and implementation plan
|
||||||
> 3. Use `/continue-feature` or drag the folder into a conversation to start implementing
|
> 3. Run `/publish-to-github` to create GitHub issues and project
|
||||||
|
> 4. Use `/continue-feature` to start implementing
|
||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
|
|
||||||
@@ -87,3 +134,4 @@ After creating the feature, inform the user:
|
|||||||
- Tasks should produce working, testable code when complete
|
- Tasks should produce working, testable code when complete
|
||||||
- Use clear, descriptive task names that explain what will be done
|
- Use clear, descriptive task names that explain what will be done
|
||||||
- Note dependencies explicitly when tasks must be done in order
|
- Note dependencies explicitly when tasks must be done in order
|
||||||
|
- Common manual tasks: account creation, API key generation, environment variables, OAuth app configuration, DNS/domain setup, billing setup, third-party service registration
|
||||||
|
|||||||
Reference in New Issue
Block a user