{"id":32458417,"url":"https://github.com/mym0404/pttn","last_synced_at":"2025-10-26T10:56:57.148Z","repository":{"id":312008769,"uuid":"1045952913","full_name":"mym0404/pttn","owner":"mym0404","description":"Store your coding pattern and refer from coding agent","archived":false,"fork":false,"pushed_at":"2025-10-03T03:55:28.000Z","size":1446,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-25T01:55:27.833Z","etag":null,"topics":["ai","claude-code","context","management","mcp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mym0404.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-28T01:03:07.000Z","updated_at":"2025-10-23T17:35:14.000Z","dependencies_parsed_at":"2025-08-28T08:46:53.442Z","dependency_job_id":"5f115acb-d3f0-473c-acaf-d23fa5f7691b","html_url":"https://github.com/mym0404/pttn","commit_stats":null,"previous_names":["mym0404/cc-self-refer","mym0404/pttn"],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/mym0404/pttn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mym0404%2Fpttn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mym0404%2Fpttn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mym0404%2Fpttn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mym0404%2Fpttn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mym0404","download_url":"https://codeload.github.com/mym0404/pttn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mym0404%2Fpttn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281092767,"owners_count":26442440,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","context","management","mcp"],"created_at":"2025-10-26T10:56:56.254Z","updated_at":"2025-10-26T10:56:57.139Z","avatar_url":"https://github.com/mym0404.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.svg\" alt=\"pttn thumbnail\" width=\"100%\" max-width=\"800px\" /\u003e\n\u003c/div\u003e\n\n# pttn\n\n**Claude Code Pattern Helper** - The missing backend for intelligent development workflows with AI assistance.\n\n## What is pttn?\n\n`pttn` is a high-performance Node.js CLI that powers Claude Code's pattern management capabilities. It enables projects to maintain their own development patterns that Claude can reference and build upon across sessions.\n\n## Why do you need this?\n\n### The Problem\n\n- **Context Loss**: AI conversations lose context between sessions\n- **Repeated Patterns**: You constantly re-explain project architecture, decisions, and patterns\n- **Code Templates Scattered**: Code patterns and templates are spread across different tools\n- **Inefficient Workflows**: No systematic way to build and reference project-specific code patterns\n\n### The Solution\n\n`pttn` creates a **persistent, searchable pattern library** for your projects that Claude Code can intelligently reference:\n\n- 🧩 **Code Patterns**: Build a library of reusable, project-specific code templates\n- 📝 **Coding Guidelines**: Project-specific coding standards and best practices\n- 🔍 **Intelligent Search**: Find relevant information instantly with semantic search\n\n## Quick Setup\n\n### 0. Install Package (Recommended)\n\n```bash\npnpm add -D pttn # or other package manager installation command\n```\n\n### 1. Run Initialization Commands\n\n```bash\n# Download commands \u0026 other stuffs for pattern structure\nnpx pttn get-commands\n```\n\n### 2. Run your **claude-code** in your project root and pass this prompt.\n\n```bash\nThe following commands will print the prompt out for setting up claude code pattern management system.\n\nRun `npx pttn init-get-prompt` and follow instructions step by step.\n\n- You shouldn\\'t fill [PATTERN LIST] at now.\n- Copy exactly same content from the CLAUDE.md content of the prompt.\n```\n\nThat's it! Your project now has intelligent self-reference capabilities.\n\nRestart claude-code and start creating patterns with `/pttn-create` command.\n\n## What Gets Created\n\nAfter running `/init-claude`, your project will have:\n\n```\nyour-project/\n├── CLAUDE.md              # 📜 Project Overview for Claude and command usages (merged if exists)\n├── .claude/\n│   ├── commands/           # 🎯 Claude Code Commands\n│   │   ├── pttn-use.md # Apply code patterns\n│   │   ├── pttn-create.md     # Save new patterns\n│   │   └── guide-create.md       # Create coding guidelines\n│   │\n│   └── patterns/     # 🧩 Reusable Code Templates\n│       └── [numbered patterns like: 001-react-hook.md]\n└── [your project files]\n```\n\n## How It Works\n\n### 🧩 `.claude/patterns/` - Reusable Templates\n\n- **Purpose**: Project-specific code patterns and templates\n- **Usage**: `/pttn-create` to save patterns; `/pttn-use` to apply them\n- **Content**: Component templates, utility functions, configuration patterns\n- **AI Benefit**: Claude can apply your established patterns instead of generic solutions\n\n### 📝 `CLAUDE.md` - Coding Guidelines\n\n- **Purpose**: Project-specific coding standards and best practices stored directly in CLAUDE.md\n- **Usage**: `/guide-create` to add new guidelines; automatically referenced by Claude\n- **Content**: Code style rules, library preferences, architectural conventions, error handling patterns\n- **AI Benefit**: Claude follows your established coding standards and project conventions automatically\n\n## Why This Works\n\nThe tool builds **persistent AI context** through:\n\n1. **Patterns** ensure consistency across your codebase\n2. **Guidelines** enforce coding standards\n\nThe result: Claude becomes increasingly intelligent about your specific project over time.\n\n---\n\n## Todo\n\n- Test\n- Docs\n  - how to use for good\n  - what are each component\n  - guide \u0026 tip\n- Guide files on init\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution guidelines.\n\n## License\n\nMIT © 2025 MJ Studio\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmym0404%2Fpttn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmym0404%2Fpttn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmym0404%2Fpttn/lists"}