From f72d6ced135bfccdcf2297f28f7ca22184c7af8e Mon Sep 17 00:00:00 2001 From: abozezo-dev Date: Fri, 17 Jul 2026 23:05:01 +0300 Subject: [PATCH] Add project planning skill --- README.md | 31 +++---- skills.sh.json | 7 ++ skills/project-planning/SKILL.md | 150 +++++++++++++++++++++++++++++++ 3 files changed, 173 insertions(+), 15 deletions(-) create mode 100644 skills/project-planning/SKILL.md diff --git a/README.md b/README.md index 72c2041..9658d45 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# πŸ›‘οΈ Code Verification & Cleaning Skill +# πŸ›‘οΈ Code Verification, Cleaning & Planning Skills -> **A reusable AI skill for code verification, cleanup, runtime auditing, and security-focused review, organized under `skills/code-verify-and-clean-skill/` for skills.sh discovery.** +> **Reusable AI skills for project planning, code verification, cleanup, runtime auditing, and security-focused review.** ![License](https://img.shields.io/badge/license-MIT-blue.svg) ![Status](https://img.shields.io/badge/status-active-success.svg) @@ -50,10 +50,18 @@ This skill empowers AI agents to: ### Installation +#### Code Verification & Cleaning + ```bash npx skills add abozezo-dev/Code-Quality-Skill/code-verify-and-clean-skill ``` +#### Project Planning + +```bash +npx skills add abozezo-dev/Code-Quality-Skill/project-planning +``` + ### Quick Start 1. Add the skill to your AI agent configuration @@ -64,21 +72,12 @@ npx skills add abozezo-dev/Code-Quality-Skill/code-verify-and-clean-skill ## πŸ”— Skills.sh Listing -View this skill on skills.sh: - -- [Code Verification & Cleaning Skill](https://skills.sh/abozezo-dev/Code-Quality-Skill/code-verify-and-clean-skill) - -The repository page is customized with [`skills.sh.json`](skills.sh.json), and the skill files live under [`skills/code-verify-and-clean-skill/`](skills/code-verify-and-clean-skill/) for a clean skills.sh-compatible layout. - ---- - -## πŸ”— Skills.sh Listing - -View this skill on skills.sh: +View these skills on skills.sh: - [Code Verification & Cleaning Skill](https://skills.sh/abozezo-dev/Code-Quality-Skill/code-verify-and-clean-skill) +- [Project Planning Skill](https://skills.sh/abozezo-dev/Code-Quality-Skill/project-planning) -The repository page is customized with [`skills.sh.json`](skills.sh.json), which groups this skill under **Code Quality** for easier discovery. +The repository page is customized with [`skills.sh.json`](skills.sh.json), which groups the skills for easier discovery. Skill definitions live under [`skills/`](skills/) in a skills.sh-compatible layout. --- @@ -87,6 +86,8 @@ The repository page is customized with [`skills.sh.json`](skills.sh.json), which ``` Code-Quality-Skill/ β”œβ”€β”€ skills/ +β”‚ β”œβ”€β”€ project-planning/ +β”‚ β”‚ └── SKILL.md # Planning-only skill specification β”‚ └── code-verify-and-clean-skill/ β”‚ β”œβ”€β”€ assets/ β”‚ β”‚ β”œβ”€β”€ report-template.md # Post-modification report template @@ -217,4 +218,4 @@ SOFTWARE. --- -

Made with ❀️ by abozezo-dev

\ No newline at end of file +

Made with ❀️ by abozezo-dev

diff --git a/skills.sh.json b/skills.sh.json index 66be6f0..97d2ae2 100644 --- a/skills.sh.json +++ b/skills.sh.json @@ -2,6 +2,13 @@ "$schema": "https://skills.sh/schemas/skills.sh.schema.json", "notGrouped": "bottom", "groupings": [ + { + "title": "Project Planning", + "description": "Requirements clarification, milestone planning, and implementation-ready delivery plans.", + "skills": [ + "project-planning" + ] + }, { "title": "Code Quality", "description": "Code verification, cleanup, runtime auditing, and security review skills.", diff --git a/skills/project-planning/SKILL.md b/skills/project-planning/SKILL.md new file mode 100644 index 0000000..e0aef29 --- /dev/null +++ b/skills/project-planning/SKILL.md @@ -0,0 +1,150 @@ +--- +name: project-planning +description: | + Turns a requested change into an implementation-ready plan by clarifying requirements, + documenting assumptions, assessing risks and dependencies, sequencing milestones, and + defining verifiable acceptance criteria. Use before implementation when scope, behavior, + constraints, or delivery steps need to be agreed. +allowed-tools: + - Read + - Grep + - Glob + - Bash + - WebFetch +--- + +# Project Planning Skill + +Create a shared, implementation-ready plan before changing application code. This skill is +planning-only: gather evidence, clarify the requested outcome, and obtain agreement (or enough +specificity to proceed) before handing work to an implementation workflow. + +## When to Use This Skill + +- A request has unclear scope, users, behavior, success measures, or constraints. +- A feature, migration, integration, refactor, or rollout needs coordinated execution. +- A team needs an ordered plan that another agent can implement without rediscovering decisions. +- Risks, dependencies, trade-offs, or acceptance criteria need explicit treatment. + +## Planning Boundary + +- **Do not modify application code, configuration, infrastructure, tests, or production data.** +- Do not start implementation, run destructive migrations, or make speculative fixes while planning. +- Read-only repository inspection and non-mutating discovery commands are allowed when they reduce + uncertainty. +- Planning artifacts may be drafted only when requested or when the surrounding workflow permits + them; they must describe proposed work, not implement it. +- If requirements remain material and unresolved, ask targeted questions and clearly mark the plan + as pending agreement rather than guessing. + +## Workflow + +### 1. Establish the Planning Context + +1. Restate the requested outcome in one or two sentences. +2. Inspect relevant existing documentation, architecture, interfaces, and conventions using + read-only methods. +3. Record the current state, the desired state, affected users or systems, and explicit + out-of-scope items. +4. Separate known facts from assumptions and open questions. + +### 2. Ask Targeted Questions + +Ask only questions whose answers change scope, design, sequencing, cost, risk, or acceptance. +Prefer a short, prioritized set over a broad questionnaire. Cover gaps such as: + +- **Outcome:** What user or business problem must be solved, and how will success be measured? +- **Behavior:** What are the primary flows, edge cases, failure behavior, and non-goals? +- **Constraints:** What compatibility, performance, accessibility, security, privacy, budget, or + deadline constraints apply? +- **Ownership:** Who approves decisions, supplies content or credentials, and operates the result? +- **Delivery:** Is there a required rollout, migration, feature flag, monitoring, or rollback plan? + +For each question, state why it matters. If an answer is unavailable, propose a bounded default +assumption and label it for confirmation. + +### 3. Record Assumptions and Decisions + +Maintain an assumptions and decisions log with: + +| Item | Type | Rationale | Owner / source | Status | +| --- | --- | --- | --- | --- | +| Example: existing authentication is reused | Assumption | avoids a new identity flow | requester | needs confirmation | + +Mark every item as **confirmed**, **proposed**, or **open**. Never present a proposed assumption +as an agreed requirement. Identify which open items block planning or implementation. + +### 4. Identify Dependencies and Risks + +List dependencies that affect sequencing or delivery, including external services, APIs, data, +teams, approvals, environments, licenses, and release windows. For each material risk, capture: + +| Risk | Likelihood | Impact | Early signal | Mitigation | Contingency | Owner | +| --- | --- | --- | --- | --- | --- | --- | + +Prioritize risks that could invalidate the approach, delay a milestone, compromise safety, or +require a decision before implementation. Convert unresolved high-impact risks into explicit +decision gates. + +### 5. Break Work into Ordered Milestones + +Create small, outcome-oriented milestones in dependency order. Each milestone must state: + +1. **Goal and scope** β€” the observable outcome and included/excluded work. +2. **Prerequisites** β€” decisions, inputs, or prior milestones required to begin. +3. **Implementation approach** β€” the proposed components, interfaces, data changes, and validation + strategy at a level sufficient for an implementer to act. +4. **Deliverables and owner** β€” concrete outputs and responsible party. +5. **Acceptance criteria** β€” objective conditions proving the milestone is complete. +6. **Risks and rollback considerations** β€” relevant mitigations, release safeguards, and recovery + needs. + +Sequence discovery and decision gates before dependent build work. Call out parallelizable work +only when dependencies genuinely permit it. + +### 6. Produce the Implementation-Ready Plan + +Deliver a plan with the following structure: + +```markdown +# Plan + +## Objective +## Scope and Non-Goals +## Current-State Findings +## Requirements +## Open Questions and Assumptions +## Dependencies +## Risks and Mitigations +## Milestones +### Milestone 1 β€” +- Goal and scope: +- Prerequisites: +- Proposed approach: +- Deliverables and owner: +- Acceptance criteria: +- Risks / rollback: + +## Validation and Release Approach +## Decision Gates and Approval Needed +``` + +Make acceptance criteria observable and testable. Prefer statements such as β€œan authorized user +can complete X and receives Y,” β€œthe migration can be rolled back without data loss,” or β€œthe +defined latency target is met under the agreed workload,” rather than β€œworks correctly.” + +### 7. Confirm Readiness Before Handoff + +Before implementation, verify that: + +- Requirements and non-goals are sufficiently specific. +- Material assumptions are confirmed or explicitly approved as defaults. +- Dependencies have owners and a feasible order. +- High-impact risks have mitigations or decision gates. +- Every milestone has measurable acceptance criteria. +- The requester has agreed to the plan, or the documented evidence establishes that the plan is + sufficiently specified for implementation under the applicable workflow. + +If any condition fails, keep the work in planning, state the blocker, and ask the next targeted +question. Hand off only the agreed or sufficiently specified plan; implementation belongs to a +separate workflow.