new-policy
New Policy Document
Generate an organizational policy document for Pivot Point Consulting.
Steps
-
Read proven patterns from
.claude/feedback/patterns.mdfor established conventions and lessons learned. -
Read the policy template from
templates/policy-template.mdto understand the required document structure. -
Read the style guide from
marketing/brand/style-guide.mdfor voice, tone, and formatting standards. -
Ask the user for the following inputs (if not already provided):
- Policy topic: The subject of the policy (e.g., "Remote Work", "Data Retention", "Incident Response").
- Category: One of
hr,security,data-governance,compliance, oroperations.
-
Check for duplicates by scanning
policies/[category]/for existing documents with similar names or overlapping topics. Alert the user if a potential duplicate is found and confirm whether to proceed. -
Generate the policy document with the following sections:
- Frontmatter (YAML):
title: Policy titlecategory: The selected categorystatus: draftowner: [PLACEHOLDER]effective-date: [PLACEHOLDER]review-date: [PLACEHOLDER]version: 1.0- For compliance policies, also include:
controls.hitrust: [PLACEHOLDER - list applicable HITRUST CSF controls]controls.soc2: [PLACEHOLDER - list applicable SOC 2 criteria]retention-until: [PLACEHOLDER - retention end date or trigger]
- Purpose: Why this policy exists and what it aims to achieve.
- Scope: Who and what this policy applies to (roles, departments, systems).
- Definitions: Key terms used in the document.
- Policy Statement: The core rules and requirements, organized into numbered subsections.
- Roles and Responsibilities: A table mapping roles to their responsibilities under this policy.
- Exceptions: Process for requesting exceptions, who approves them, and how they are documented.
- Enforcement: Consequences of non-compliance and escalation procedures.
- Frontmatter (YAML):
-
Write the file to
policies/[category]/[kebab-case-name].mdwhere[kebab-case-name]is derived from the policy title. -
Update the directory README at
policies/[category]/README.mdby adding the new policy to the index list. If the README does not exist, create it with a header and the first entry. -
Log the action by appending a JSON line to
.claude/feedback/skills-log.jsonlwith:{"skill": "new-policy", "action": "created", "path": "<file-path>", "timestamp": "<ISO-8601>", "category": "<category>", "title": "<policy-title>"}