add claude and gitignore
This commit is contained in:
53
{{cookiecutter.project_slug}}/.claude/commands/architect.md
Normal file
53
{{cookiecutter.project_slug}}/.claude/commands/architect.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
description: Create architectural overview
|
||||||
|
argument-hint: [files or context]
|
||||||
|
---
|
||||||
|
|
||||||
|
You are a senior software architect. Before designing anything, identify what
|
||||||
|
you don't know. Ask me up to 5 clarifying questions — prioritize questions
|
||||||
|
that would change the architecture. Wait for my answers before proceeding.
|
||||||
|
|
||||||
|
the project documentation is in `docs` folder.
|
||||||
|
For context, use `docs/user-stories.md` file if available.
|
||||||
|
|
||||||
|
|
||||||
|
Once you have enough context, produce a project architecture document `docs/architecture.md` with these sections:
|
||||||
|
|
||||||
|
# Architecture: [Project Name]
|
||||||
|
|
||||||
|
## Problem and context
|
||||||
|
What problem this solves and for whom.
|
||||||
|
|
||||||
|
## Goals and non-goals
|
||||||
|
Numbered goals with measurable criteria. Explicit non-goals.
|
||||||
|
|
||||||
|
## System overview
|
||||||
|
One paragraph. Then a Mermaid component diagram showing the major
|
||||||
|
components, their responsibilities, and how they communicate.
|
||||||
|
|
||||||
|
## Technology stack
|
||||||
|
| Component | Technology | Version | Rationale |
|
||||||
|
|
||||||
|
## Module boundaries
|
||||||
|
For each module: what it owns, its public interface, and what it must NOT
|
||||||
|
do. Communication patterns between modules (sync/async, events, RPC).
|
||||||
|
|
||||||
|
## Key architectural decisions
|
||||||
|
For each significant decision:
|
||||||
|
- **Decision:** What was chosen
|
||||||
|
- **Alternatives considered:** What else was evaluated
|
||||||
|
- **Rationale:** Why this option
|
||||||
|
|
||||||
|
## Constraints and conventions
|
||||||
|
Tech stack rules, naming conventions, forbidden libraries, coding patterns
|
||||||
|
to follow project-wide.
|
||||||
|
|
||||||
|
## Open questions
|
||||||
|
Unresolved items that will be decided at feature-design time.
|
||||||
|
|
||||||
|
---
|
||||||
|
Rules:
|
||||||
|
- Keep the document as short as reasonably possible
|
||||||
|
- Mermaid diagrams only (no images)
|
||||||
|
- Be specific — version numbers, concrete patterns, not "we will use best practices"
|
||||||
|
- Flag every assumption with [ASSUMPTION]
|
||||||
56
{{cookiecutter.project_slug}}/.gitignore
vendored
Normal file
56
{{cookiecutter.project_slug}}/.gitignore
vendored
Normal file
@@ -0,0 +1,56 @@
|
|||||||
|
# Byte-compiled / optimized / DLL files
|
||||||
|
__pycache__/
|
||||||
|
*.py[cod]
|
||||||
|
*$py.class
|
||||||
|
|
||||||
|
# C extensions
|
||||||
|
*.so
|
||||||
|
|
||||||
|
# Distribution / packaging
|
||||||
|
.Python
|
||||||
|
build/
|
||||||
|
dist/
|
||||||
|
*.egg-info/
|
||||||
|
.eggs/
|
||||||
|
*.egg
|
||||||
|
pip-wheel-metadata/
|
||||||
|
|
||||||
|
# Virtual environments
|
||||||
|
.venv/
|
||||||
|
venv/
|
||||||
|
env/
|
||||||
|
ENV/
|
||||||
|
|
||||||
|
# Installer logs
|
||||||
|
pip-log.txt
|
||||||
|
pip-delete-this-directory.txt
|
||||||
|
|
||||||
|
# Unit test / coverage reports
|
||||||
|
.pytest_cache/
|
||||||
|
.coverage
|
||||||
|
.coverage.*
|
||||||
|
htmlcov/
|
||||||
|
coverage.xml
|
||||||
|
|
||||||
|
# Type checkers / linters
|
||||||
|
.mypy_cache/
|
||||||
|
.pyre/
|
||||||
|
.pytype/
|
||||||
|
.ruff_cache/
|
||||||
|
*_cache/
|
||||||
|
|
||||||
|
# Jupyter Notebook
|
||||||
|
.ipynb_checkpoints/
|
||||||
|
|
||||||
|
# pyenv
|
||||||
|
.python-version
|
||||||
|
|
||||||
|
# IDEs and editors
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
|
||||||
|
# OS files
|
||||||
|
.DS_Store
|
||||||
|
Thumbs.db
|
||||||
Reference in New Issue
Block a user