iikit-00-constitution

Category: Tools & Productivity | Uploader: intent-integrity-chain | Downloads: 0 | Version: v1.0（Latest）

Changelog: Source: GitHub https://github.com/intent-integrity-chain/kit

Directory Structure

Current level: tree/main/.claude/skills/iikit-00-constitution/

📁 references/
- 📄 model-recommendations.md 2.5 KB
- 📄 phase-separation-rules.md 1.6 KB
📁 scripts/
- 📁 bash/
  - 📄 common.sh 24.6 KB
  - 📄 generate-dashboard-safe.sh 1.8 KB
  - 📄 next-step.sh 14.3 KB
  - 📄 testify-tdd.sh 23.7 KB
  - 📄 validate-premise.sh 6.5 KB
- 📁 dashboard/
  - 📁 public/
    
    📄 index.html 205.7 KB
  - 📁 src/
    
    📁 public/
    
    📄 index.html 205.1 KB
    
    📄 analyze.js 7.0 KB
    
    📄 board.js 3.2 KB
    
    📄 bugs.js 4.9 KB
    
    📄 checklist.js 2.1 KB
    
    📄 generate-dashboard.js 10.2 KB
    
    📄 integrity.js 1.7 KB
    
    📄 parser.js 43.5 KB
    
    📄 pipeline.js 5.9 KB
    
    📄 planview.js 9.4 KB
    
    📄 storymap.js 1.4 KB
    
    📄 testify.js 6.2 KB
  - 📄 package.json 20 B
  - 📄 template.js 213.0 KB
- 📁 powershell/
  - 📄 common.ps1 14.3 KB
  - 📄 generate-dashboard-safe.ps1 1.8 KB
  - 📄 next-step.ps1 10.7 KB
📁 templates/
- 📄 constitution-template.md 2.3 KB
- 📄 plan-template.md 3.3 KB
- 📄 spec-template.md 3.9 KB
- 📄 tasks-template.md 5.3 KB
📄 SKILL.md 5.5 KB

SKILL.md

---
name: iikit-00-constitution
description: >-
  Create or update a CONSTITUTION.md that defines project governance — establishes coding standards, quality gates, TDD policy, review requirements, and non-negotiable development principles with versioned amendment tracking.
  Use when defining project rules, setting up coding standards, establishing quality gates, configuring TDD requirements, or creating non-negotiable development principles.
license: MIT
metadata:
  version: "1.6.4"
---

# Intent Integrity Kit Constitution

Create or update the project constitution at `CONSTITUTION.md` — the governing principles for specification-driven development.

## Scope

**MUST contain**: governance principles, non-negotiable development rules, quality standards, amendment procedures, compliance expectations.

**MUST NOT contain**: technology stack, frameworks, databases, implementation details, specific tools or versions. These belong in `/iikit-02-plan`. See [phase-separation-rules.md](../iikit-core/references/phase-separation-rules.md).

## User Input

```text
$ARGUMENTS
```

You **MUST** consider the user input before proceeding (if not empty).

## Prerequisites Check

1. **Check PREMISE.md exists**: `test -f PREMISE.md`. If missing: ERROR — "PREMISE.md not found. Run `/iikit-core init` first to create it." Do NOT proceed without PREMISE.md.
2. **Validate PREMISE.md**:
   ```bash
   bash .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/bash/validate-premise.sh --json
   ```
   If FAIL (missing sections or placeholders): ERROR — show details, suggest re-running init.
3. Check if constitution exists: `cat CONSTITUTION.md 2>/dev/null || echo "NO_CONSTITUTION"`
4. If missing, copy from [constitution-template.md](../iikit-core/templates/constitution-template.md)

## Execution Flow

1. **Load existing constitution** — identify placeholder tokens `[ALL_CAPS_IDENTIFIER]`. Adapt to user's needs (more or fewer principles than template).

2. **Collect values for placeholders**:
   - From user input, or infer from repo context
   - `RATIFICATION_DATE`: original adoption date
   - `LAST_AMENDED_DATE`: today if changes made
   - `CONSTITUTION_VERSION`: semver (MAJOR: principle removal/redefinition, MINOR: new principle, PATCH: clarifications)

3. **Draft content**: replace all placeholders, preserve heading hierarchy, ensure each principle has name + rules + rationale, governance section covers amendment/versioning/compliance.

4. **Consistency check**: validate against [plan-template.md](../iikit-core/templates/plan-template.md), [spec-template.md](../iikit-core/templates/spec-template.md), [tasks-template.md](../iikit-core/templates/tasks-template.md).

5. **Sync Impact Report** (HTML comment at top): version change, modified principles, added/removed sections, follow-up TODOs.

6. **Validate**: no remaining bracket tokens, version matches report, dates in ISO format, principles are declarative and testable. Constitution MUST have at least 3 principles — if fewer, add more based on the project context.

7. **Phase separation validation**: scan for technology-specific content per [phase-separation-rules.md](../iikit-core/references/phase-separation-rules.md). Auto-fix violations, re-validate until clean.

8. **Write** to `CONSTITUTION.md`

9. **Store TDD determination** in `.specify/context.json` so all skills read from here instead of re-parsing the constitution:
   ```bash
   TDD_DET=$(bash .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/bash/testify-tdd.sh get-tdd-determination "CONSTITUTION.md")
   ```
   Write to `.specify/context.json` using `jq` (merge, don't overwrite):
   ```bash
   jq --arg det "$TDD_DET" '. + {tdd_determination: $det}' .specify/context.json > .specify/context.json.tmp && mv .specify/context.json.tmp .specify/context.json
   ```
   If `.specify/context.json` doesn't exist, create it: `echo '{}' | jq --arg det "$TDD_DET" '{tdd_determination: $det}' > .specify/context.json`

10. **Git init** (if needed): `git init` to ensure project isolation

11. **Commit**: `git add CONSTITUTION.md .specify/context.json && git commit -m "Add project constitution"`

12. **Dashboard Refresh** (optional, never blocks):
```bash
bash .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/bash/generate-dashboard-safe.sh
```
Windows: `pwsh .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/powershell/generate-dashboard-safe.ps1`

13. **Report**: version, bump rationale, TDD determination, git status, suggested next steps

## Formatting

- Markdown headings per template, lines <100 chars, single blank line between sections, no trailing whitespace.

## Next Steps

Run: `bash .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/bash/next-step.sh --phase 00 --json`
Windows: `pwsh .tessl/tiles/tessl-labs/intent-integrity-kit/skills/iikit-core/scripts/powershell/next-step.ps1 -Phase 00 -Json`

Parse the JSON and present:
1. If `clear_after` is true: suggest `/clear` before proceeding
2. Present `next_step` as the primary recommendation
3. If `alt_steps` non-empty: list as alternatives
4. For `next_step` and each `alt_step`, include the `model_tier` from the JSON so the user knows which model is best for each option. Look up tiers in [model-recommendations.md](../iikit-core/references/model-recommendations.md) for agent-specific switch commands.
5. Append dashboard link

Format:
```
Constitution ready!
Next: [/clear → ] <next_step> (model: <tier>)
[- <alt_step> — <reason> (model: <tier>)]

- Dashboard: file://$(pwd)/.specify/dashboard.html (resolve the path)
```

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

iikit-00-constitution

Directory Structure

SKILL.md

Report

Notice