deft

Category: Development & Coding | Uploader: visionik | Downloads: 0 | Version: v1.0（Latest）

Apply deft framework standards for AI-assisted development. Use when starting projects, writing code, running tests, making commits, or when the user references deft, project standards, or coding guidelines.

Changelog: Source: GitHub https://github.com/visionik/deft

Directory Structure

Current level: Root

📁 __pycache__/
- 📄 runcpython-314.pyc 109.4 KB
📁 coding/
- 📄 coding.md 5.0 KB
- 📄 testing.md 4.5 KB
📁 context/
- 📄 context.md 3.0 KB
- 📄 deterministic-split.md 3.1 KB
- 📄 examples.md 1.1 KB
- 📄 fractal-summaries.md 2.7 KB
- 📄 long-horizon.md 1.9 KB
- 📄 spec-deltas.md 5.3 KB
- 📄 tool-design.md 1.5 KB
- 📄 working-memory.md 2.4 KB
📁 contracts/
- 📄 boundary-maps.md 2.7 KB
📁 core/
- 📄 glossary.md 6.6 KB
- 📄 project.md 2.2 KB
- 📄 ralph.md 6.9 KB
- 📄 versioning.md 10.4 KB
📁 deployments/
- 📁 agentuity/
  - 📄 README.md 5.8 KB
  - 📄 via-cli.md 6.6 KB
  - 📄 via-cloud.md 8.3 KB
  - 📄 via-github-actions.md 14.2 KB
  - 📄 via-gravity-network.md 13.5 KB
  - 📄 via-vpc.md 13.0 KB
- 📁 aws/
  - 📄 README.md 1.7 KB
  - 📄 via-app-runner.md 13.7 KB
  - 📄 via-ecs-fargate.md 13.4 KB
  - 📄 via-elastic-beanstalk.md 11.8 KB
  - 📄 via-lambda.md 12.3 KB
- 📁 azure/
  - 📄 README.md 1.7 KB
  - 📄 via-aks.md 7.3 KB
  - 📄 via-app-service.md 11.6 KB
  - 📄 via-container-apps.md 12.6 KB
  - 📄 via-functions.md 12.2 KB
- 📁 cloud-gov/
  - 📁 agents/
    
    📄 compliance-docs.md 4.0 KB
  - 📁 upstream/
    
    📄 README.md 319 B
  - 📄 agents.md 953 B
  - 📄 cicd.md 1.4 KB
  - 📄 deployment.md 2.2 KB
  - 📄 logging.md 804 B
  - 📄 manifest.md 1.8 KB
  - 📄 overview.md 1.7 KB
  - 📄 README.md 1.6 KB
  - 📄 security.md 1.1 KB
  - 📄 services.md 1.6 KB
- 📁 cloudflare/
  - 📄 README.md 1.4 KB
  - 📄 via-dashboard.md 3.3 KB
  - 📄 via-git.md 3.9 KB
  - 📄 via-github-actions.md 5.6 KB
  - 📄 via-terraform.md 5.0 KB
  - 📄 via-wrangler.md 4.8 KB
- 📁 fly-io/
  - 📄 README.md 1.4 KB
  - 📄 via-dockerfile.md 10.0 KB
  - 📄 via-flyctl.md 9.9 KB
  - 📄 via-github-actions.md 14.5 KB
  - 📄 via-multi-region.md 11.3 KB
- 📁 google/
  - 📄 README.md 1.2 KB
  - 📄 via-app-engine.md 844 B
  - 📄 via-cloud-functions.md 531 B
  - 📄 via-cloud-run.md 6.8 KB
  - 📄 via-gke.md 510 B
- 📁 netlify/
  - 📄 README.md 2.9 KB
  - 📄 via-cli.md 289 B
  - 📄 via-functions.md 369 B
  - 📄 via-git.md 523 B
- 📁 vercel/
  - 📄 README.md 2.6 KB
  - 📄 via-api.md 432 B
  - 📄 via-cli.md 284 B
  - 📄 via-git.md 488 B
- 📄 README.md 811 B
📁 docs/
- 📄 ai-coding-trust-paradox.md 4.3 KB
- 📄 claude-code-integration.md 9.6 KB
📁 history/
- 📁 archive/
  - 📄 .gitkeep 0 B
- 📁 changes/
  - 📄 .gitkeep 0 B
- 📄 README.md 1.6 KB
📁 interfaces/
- 📄 cli.md 2.8 KB
- 📄 rest.md 6.3 KB
- 📄 tui.md 7.6 KB
- 📄 web.md 5.7 KB
📁 languages/
- 📄 6502-DASM.md 6.2 KB
- 📄 c#.md 10.7 KB
- 📄 c.md 9.3 KB
- 📄 commands.md 782 B
- 📄 cpp.md 4.6 KB
- 📄 dart.md 7.3 KB
- 📄 delphi.md 8.6 KB
- 📄 elixir.md 8.4 KB
- 📄 go.md 1.7 KB
- 📄 java.md 10.6 KB
- 📄 javascript.md 5.0 KB
- 📄 julia.md 6.8 KB
- 📄 kotlin.md 7.1 KB
- 📄 markdown.md 7.1 KB
- 📄 mermaid.md 2.7 KB
- 📄 python.md 4.4 KB
- 📄 r.md 6.2 KB
- 📄 rust.md 7.9 KB
- 📄 sql.md 9.3 KB
- 📄 swift.md 4.6 KB
- 📄 typescript.md 3.3 KB
- 📄 vhdl.md 5.7 KB
- 📄 visual-basic.md 5.7 KB
- 📄 zig.md 7.2 KB
📁 meta/
- 📄 code-field.md 1.9 KB
- 📄 ideas.md 259 B
- 📄 lessons.md 902 B
- 📄 morals.md 1.2 KB
- 📄 SOUL.md 1.6 KB
- 📄 suggestions.md 58 B
📁 old/
- 📄 project.md 1.1 KB
- 📄 user.md 823 B
📁 platforms/
- 📄 2600.md 7.7 KB
- 📄 unity.md 15.1 KB
📁 resilience/
- 📄 context-pruning.md 3.1 KB
- 📄 continue-here.md 2.5 KB
📁 scm/
- 📄 changelog.md 6.3 KB
- 📄 git.md 3.9 KB
- 📄 github.md 6.7 KB
📁 secrets/
- 📄 .gitkeep 0 B
📁 strategies/
- 📄 brownfield.md 2.7 KB
- 📄 default.md 5.4 KB
- 📄 discuss.md 4.0 KB
- 📄 interview.md 5.5 KB
- 📄 map.md 2.7 KB
- 📄 README.md 1.8 KB
- 📄 research.md 3.1 KB
- 📄 speckit.md 8.4 KB
- 📄 yolo.md 5.9 KB
📁 swarm/
- 📄 swarm.md 8.5 KB
📁 taskfiles/
- 📄 deployments.yml 2.8 KB
📁 templates/
- 📄 make-spec-example.md 1.5 KB
- 📄 make-spec.md 3.1 KB
- 📄 project.md.template 1.4 KB
- 📄 specification.md 24 B
- 📄 user.md.template 896 B
📁 tests/
- 📁 cli/
  - 📄 __init__.py 0 B
  - 📄 test_bootstrap.py 3.2 KB
  - 📄 test_doctor.py 1.2 KB
  - 📄 test_import_smoke.py 1.5 KB
  - 📄 test_project.py 3.5 KB
  - 📄 test_validate.py 2.2 KB
- 📁 content/
  - 📁 snapshots/
    
    📄 __init__.py 0 B
    
    📄 baseline.json 339.2 KB
    
    📄 capture.py 3.6 KB
    
    📄 known_failures.json 11.0 KB
  - 📄 __init__.py 0 B
  - 📄 test_contracts.py 7.7 KB
  - 📄 test_shape.py 5.4 KB
  - 📄 test_standards.py 6.9 KB
  - 📄 test_structure.py 5.1 KB
  - 📄 test_vbrief_schema.py 4.3 KB
- 📁 fixtures/
  - 📁 mock_configs/
    
    📄 .gitkeep 0 B
    
    📄 __init__.py 0 B
  - 📄 __init__.py 0 B
  - 📄 shapes.py 3.5 KB
- 📄 __init__.py 0 B
- 📄 conftest.py 6.7 KB
📁 tools/
- 📄 RWLDL.md 2.8 KB
- 📄 taskfile.md 4.8 KB
- 📄 telemetry.md 6.7 KB
📁 vbrief/
- 📁 schemas/
  - 📄 vbrief-core.schema.json 10.1 KB
- 📄 vbrief.md 7.2 KB
📁 verification/
- 📄 integration.md 2.7 KB
- 📄 plan-checking.md 2.8 KB
- 📄 uat.md 2.0 KB
- 📄 verification.md 3.5 KB
📄 .gitignore 482 B
📄 CHANGELOG.md 26.0 KB
📄 commands.md 6.9 KB
📄 IMPLEMENTATION-PLAN.md 4.6 KB
📄 IMPLEMENTATION.md 6.5 KB
📄 LICENSE.md 1.1 KB
📄 main.md 6.0 KB
📄 PROJECT.md 1.1 KB
📄 pyproject.toml 1.5 KB
📄 README.md 21.0 KB
📄 REFERENCES.md 9.8 KB
📄 run 96.8 KB
📄 run.bat 1022 B
📄 run.py 2.3 KB
📄 session.txt 30.3 KB
📄 session2.txt 5.3 KB
📄 SKILL.md 5.6 KB
📄 SPECIFICATION.md 13.0 KB
📄 Taskfile.yml 5.5 KB
📄 todo.md 6.9 KB
📄 uv.lock 104.9 KB

SKILL.md

---
name: deft
description: Apply deft framework standards for AI-assisted development. Use when starting projects, writing code, running tests, making commits, or when the user references deft, project standards, or coding guidelines.
user-invocable: false
metadata:
  clawdbot:
    requires:
      bins: ["task"]
    homepage: "https://github.com/visionik/deft"
os: ["darwin", "linux"]
---

# Deft Framework

A layered framework for AI-assisted development with consistent standards and workflows.

## When This Skill Activates

This skill automatically loads when you:
- Start work in a deft-enabled project (has `./deft/` directory)
- Reference deft, project standards, or coding conventions
- Run tests, make commits, or perform quality checks
- Ask about project structure, workflows, or best practices

## Core Principle: Rule Precedence

Deft uses hierarchical rules where more specific overrides general:

```
user.md          ← HIGHEST precedence (personal preferences)
  ↓
project.md       ← Project-specific rules
  ↓
{language}.md    ← Language standards (python.md, go.md, typescript.md, cpp.md)
  ↓
{tool}.md        ← Tool guidelines (taskfile.md, git.md)
  ↓
main.md          ← General AI behavior
  ↓
specification.md ← LOWEST precedence (requirements)
```

**IMPORTANT**: If `user.md` says one thing and `python.md` says another, `user.md` ALWAYS wins.

## File Reading Strategy (Lazy Loading)

**DO NOT** read all deft files at once. Read only what you need:

1. **Always start with**: `./deft/main.md` (general guidelines)
2. **Check for**: `./deft/core/user.md` (personal overrides - highest precedence)
3. **Check for**: `./deft/core/project.md` (project-specific rules)
4. **Then read language-specific** only if working with that language:
   - `./deft/languages/python.md`
   - `./deft/languages/go.md`
   - `./deft/languages/typescript.md`
   - `./deft/languages/cpp.md`
5. **Read tool files** only when using that tool:
   - `./deft/tools/taskfile.md` (when running tasks)
   - `./deft/scm/git.md` (when using git)
   - `./deft/scm/github.md` (when using GitHub)

## Task-Centric Workflow

Deft projects use **Taskfile** as the universal task runner.

```bash
task --list        # See all available tasks
task check         # CRITICAL: Run before EVERY commit
```

See `./deft/tools/taskfile.md` for complete task standards and common commands.

## Development Methodology

**Test-Driven Development (TDD)**:
1. Write test first → Watch it fail → Implement → Refactor → Repeat
2. Default: ≥85% coverage (check `project.md` for overrides)
3. Implementation is INCOMPLETE until tests pass

**Spec-Driven Development (SDD)** for new features/projects:
1. Run `deft/run spec` to generate PRD.md via AI interview
2. Review PRD.md → Generate SPECIFICATION.md → Review → Implement

See `./deft/coding/testing.md` for complete testing standards.

## Quality Standards

**Before Every Commit**:
```bash
task check  # MUST run: fmt, lint, type check, test, coverage
```

**Conventional Commits**: Use https://www.conventionalcommits.org/en/v1.0.0/ format
**File Naming**: Use hyphens (e.g., `user-service.py`), not underscores
**Secrets**: Store in `secrets/` directory with `.example` templates

See `./deft/coding/coding.md` and `./deft/scm/git.md` for complete standards.

## Language-Specific Standards

All languages require ≥85% test coverage. See language-specific files:
- `./deft/languages/python.md`
- `./deft/languages/go.md`
- `./deft/languages/typescript.md`
- `./deft/languages/cpp.md`

## New Project Setup

**Initialize new project**:
```bash
deft/run init       # Create deft structure
deft/run bootstrap  # User config (first time only)
deft/run project    # Project config
deft/run spec       # Generate PRD + SPECIFICATION (optional)
```

**Work with existing deft project**:
1. **First time?** If `./deft/core/user.md` doesn't exist, run `deft/run bootstrap`
2. Read `./deft/main.md` (general guidelines)
3. Read `./deft/core/user.md` (personal preferences - highest precedence)
4. Read `./deft/core/project.md` (project rules)
5. Run `task --list` to see available tasks

See `./deft/main.md` for complete workflow details.

## Self-Improvement

Deft learns and evolves via `meta/` directory:
- `lessons.md` - Patterns learned (AI can update)
- `ideas.md` - Future improvements
- `suggestions.md` - Project-specific suggestions

## Platform Integration

This SKILL.md follows the **AgentSkills specification**, compatible with:
- **Claude Code**: `~/.claude/skills/deft/` or `.claude/skills/deft/`
- **clawd.bot**: `~/.clawdbot/skills/deft/` or install via `clawdhub sync deft`
- **Warp AI**: Upload to Warp Drive, reference in `WARP.md`/`AGENTS.md`

See `./deft/docs/claude-code-integration.md` for integration details.

## Quick Reference

| Task | Command |
|------|---------|
| List tasks | `task` or `task --list` |
| Pre-commit checks | `task check` |
| Run tests | `task test` |
| Check coverage | `task test:coverage` |
| Format code | `task fmt` |
| Lint code | `task lint` |
| Initialize deft | `deft/run init` |
| Configure user | `deft/run bootstrap` |
| Configure project | `deft/run project` |
| Generate spec | `deft/run spec` |

## Remember

1. **Lazy load files** - Only read what you need
2. **User.md is king** - Highest precedence always
3. **Task-centric** - Use `task` for everything
4. **Test first** - Write tests before implementation
5. **Always check** - Run `task check` before commits
6. **Conventional commits** - Follow the standard
7. **Coverage matters** - ≥85% by default
8. **Never lie** - Don't claim checks passed without running them

---

For more details, read the specific files in `./deft/` as needed. Start with `main.md` and follow the precedence hierarchy.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

deft

Directory Structure

SKILL.md

Report

Notice