Skip to content
This repository was archived by the owner on Feb 14, 2026. It is now read-only.
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
id: mem-001
title: Memory Skill Implementation
tags: [embeddings, memory, rag, skills, sqlite]
category: implementation
scope: project
importance: high
created: 2026-02-07T09:46:37.735Z
---

# Memory Skill Implementation

## Summary
Implemented memory skill with SQLite + FTS5 + local embeddings for hybrid search. Uses better-sqlite3 and @xenova/transformers. Integrates with process (auto-check before implementing, auto-save after) and reviewer (auto-remember recurring issues) skills.
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
id: mem-002
title: Skill Integration Pattern
tags: [integration, patterns, process, reviewer, skills]
category: patterns
scope: project
importance: high
created: 2026-02-07T09:46:53.508Z
---

# Skill Integration Pattern

## Summary
Skills integrate via CLI calls: node ~/.claude/skills/memory/cli.js <command>. Process skill calls memory before implementing (check for prior solutions) and after (save key decisions). Reviewer skill calls memory to save recurring issues. Best-practices skill searches memory alongside best-practices directory.
Binary file added .agent/memory/memory.db
Binary file not shown.
20 changes: 20 additions & 0 deletions .ansible-lint
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
# Ansible-lint configuration

# Profile: basic (minimal rules)
profile: basic

# Skip these rules entirely
skip_list:
- var-naming[no-role-prefix] # Our variable naming is intentional
- name[casing] # Task names can start with various cases

# Warn only (don't fail) for these
warn_list:
- yaml # Let yamllint handle YAML formatting
- key-order # Key ordering is flexible

# Exclude paths
exclude_paths:
- .cache/
- test-*/
1 change: 1 addition & 0 deletions .claude/skills/commit-pr
1 change: 1 addition & 0 deletions .claude/skills/git-privacy
111 changes: 111 additions & 0 deletions .claude/skills/icc-development/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
---
name: icc-development
description: Development guide for contributing to the Intelligent Claude Code (ICC) framework. Use when working on ICC source code, creating skills, updating hooks, or modifying behaviors.
---

# ICC Framework Development Guide

This skill provides guidance for contributing to the Intelligent Claude Code framework itself.

## Project Structure

```
intelligent-claude-code/
├── src/
│ ├── skills/ # Distributed skills (main source)
│ ├── hooks/ # Claude Code hooks (enforcement)
│ ├── behaviors/ # Behavioral guidance files
│ └── ...
├── .claude/
│ └── skills/ # Local project skills (symlinks + dev tools)
├── docs/ # Documentation
├── install/ # Installation scripts
└── CLAUDE.md # Project entry point
```

## Key Principle

**This project IS the ICC framework source.**

- Changes to `src/skills/` affect what users install
- Changes to `src/hooks/` affect enforcement rules
- Local `.claude/skills/` contains symlinks for testing

## Creating New Skills

### Location
- **Distributed skills**: `src/skills/<skill-name>/SKILL.md`
- **Project-local skills**: `.claude/skills/<skill-name>/SKILL.md`

### Skill Structure
```markdown
---
name: skill-name
description: Brief description for skill matching. Include trigger phrases.
---

# Skill Title

Content with sections, examples, and guidance.
```

### Testing Skills Locally

**Setup symlinks** (once per clone):
```bash
cd .claude/skills
ln -sf ../../src/skills/commit-pr commit-pr
ln -sf ../../src/skills/git-privacy git-privacy
# Add more symlinks as needed for skills being developed
```

**Workflow:**
1. Create/modify skill in `src/skills/`
2. Add symlink in `.claude/skills/` if new skill
3. Test by invoking the skill via description matching
4. Commit changes to `src/skills/` (source)

## Modifying Hooks

### Location
`src/hooks/*.js`

### Key Hooks
- `summary-file-enforcement.js` - File placement rules
- `agent-infrastructure-protection.js` - System file protection

### Testing Hooks
Hooks are installed to `~/.claude/hooks/` during installation.
For local testing, manually copy or symlink.

## Adding Behaviors

### Location
`src/behaviors/*.md`

### Guidelines
- Behaviors are always-active structural rules
- Keep minimal - use skills for conditional guidance
- Import in CLAUDE.md with `@./path/to/behavior.md`

## Rollout Process

1. **Develop**: Make changes in `src/`
2. **Test locally**: Use symlinks in `.claude/skills/`
3. **Commit**: Follow conventional commit format
4. **PR**: Create PR for review
5. **Release**: Merge triggers installation update

## Do NOT

- Modify `~/.claude/skills/` directly (that's installed location)
- Commit to main branch directly
- Add AI attribution (git-privacy enforced)
- Create overly broad hooks that block legitimate work

## Naming Conventions

- Skills: `lowercase-hyphenated`
- Hooks: `lowercase-hyphenated.js`
- Behaviors: `lowercase-hyphenated.md`
- Commit types: feat, fix, docs, refactor, test, chore, style, perf
1 change: 1 addition & 0 deletions .claude/skills/icc-setup
1 change: 1 addition & 0 deletions .claude/skills/process
1 change: 1 addition & 0 deletions .claude/skills/reviewer
118 changes: 0 additions & 118 deletions .github/workflows/memory-check.yml

This file was deleted.

24 changes: 17 additions & 7 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -78,18 +78,28 @@ NOTES.md
999_progress/

# Claude configuration (user-specific, not source code)
.claude/
# NOTE: .claude/skills/ is tracked in THIS project (ICC framework source)
.claude/*
!.claude/skills/

# CRITICAL: Memory must NEVER be committed - local learning only!
# If you see memory/ files in git status, DO NOT COMMIT THEM
# Old memory location (deprecated, kept for backwards compatibility)
memory/
memory/**/*
*.memory
*.learning

# AgentTasks should also remain local
# Memory skill source code is tracked
!src/skills/memory/
!src/skills/memory/**
# But exclude runtime dependencies from memory skill
src/skills/memory/node_modules/
src/skills/memory/package-lock.json

# AgentTasks should remain local
agenttasks/

# Agent directory - most is local, but memory and queue are tracked
.agent/*
!.agent/memory/
!.agent/queue/

# Credentials
*.pem
*.key
Expand Down
26 changes: 26 additions & 0 deletions .yamllint
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
extends: default

rules:
line-length:
max: 120
level: warning
truthy:
# GitHub Actions uses 'on:' keyword (truthy warning)
check-keys: false
document-start: disable
comments:
min-spaces-from-content: 1
comments-indentation: false
braces:
min-spaces-inside: 0
max-spaces-inside: 1
brackets:
min-spaces-inside: 0
max-spaces-inside: 0
indentation:
# GitHub Actions uses 2-space indentation with list items at same level
indent-sequences: whatever
octal-values:
forbid-implicit-octal: true
forbid-explicit-octal: true
Loading