Initial extract: templates + methodology guide from Ideation
Public, version-controlled source of truth for TeamIDE's project templates, coding conventions, and the build-plan → PM scaffolding rules. Mounted read-only by TeamIDE's planner agent at runtime. Extracted from the personal Ideation repo as a precondition for workspace-projects-agent-spec.md §9.4. Personal Ideation stays private; this repo holds only the publishable methodology.
This commit is contained in:
@@ -0,0 +1,72 @@
|
||||
# Development Guide
|
||||
|
||||
> Development workflow and practices for [Project Name]
|
||||
|
||||
## Development Workflow
|
||||
|
||||
### Build and Run
|
||||
|
||||
This project uses a **build-and-run** approach (not hot reload):
|
||||
|
||||
```bash
|
||||
cd app
|
||||
./build.sh -dev -open # Build and launch
|
||||
./build.sh logs # View console output
|
||||
```
|
||||
|
||||
### Why Build-and-Run?
|
||||
|
||||
- **Dev = Prod** - What you test is what ships
|
||||
- **Full logging** - Console output captured to files
|
||||
- **No dev-only bugs** - Identical to production environment
|
||||
|
||||
## Making Changes
|
||||
|
||||
### Adding a New Feature
|
||||
|
||||
1. Create components in `src/components/`
|
||||
2. Add pages in `src/pages/`
|
||||
3. Register routes in `src/router/`
|
||||
4. Add state management in `src/stores/`
|
||||
5. **Rebuild to test**: `./build.sh -dev -open`
|
||||
6. **Document the feature** in `docs/`
|
||||
|
||||
### Adding a Tauri Command
|
||||
|
||||
1. Add the command in `src-tauri/src/main.rs`
|
||||
2. Register it in the `invoke_handler`
|
||||
3. Call from frontend with `invoke('command_name', { args })`
|
||||
|
||||
## Debugging
|
||||
|
||||
### Console Logs
|
||||
|
||||
```bash
|
||||
./build.sh logs # Last 100 lines
|
||||
cat build/console/console_latest.log # Full log
|
||||
```
|
||||
|
||||
### Build Errors
|
||||
|
||||
```bash
|
||||
cat build/logs/build_latest.log
|
||||
```
|
||||
|
||||
### Common Issues
|
||||
|
||||
| Issue | Solution |
|
||||
|-------|----------|
|
||||
| Build fails with cache errors | `./build.sh clean && ./build.sh -dev -open` |
|
||||
| Changes not appearing | Rebuild - this is build-and-run, not hot reload |
|
||||
| Console logs missing | Check `console-logger.ts` is in boot files |
|
||||
|
||||
## Code Style
|
||||
|
||||
- **Components**: PascalCase (`UserProfile.vue`)
|
||||
- **Composables**: camelCase with `use` prefix (`useAuth.ts`)
|
||||
- **Stores**: camelCase (`userStore.ts`)
|
||||
- **Types**: PascalCase (`UserProfile.ts`)
|
||||
|
||||
## Testing
|
||||
|
||||
[Add testing instructions when implemented]
|
||||
Reference in New Issue
Block a user