🎨 Palette: Improve documentation DX and accessibility

.template/docs/template.md

@@ -5,7 +5,7 @@ Template description for ${title_name}.
 
 1.  **AWS Lambda function**: Handles events.
 
-![Architecture diagram](diagrams/${name}.png)
+![Architecture diagram showing ${title_name} component interaction and data flow](diagrams/${name}.png)
 
 ## Code
 
@@ -18,5 +18,5 @@ Template description for ${title_name}.
 Deploy the stack using:
 
 ```bash
-make deploy STACK=${name}
+mise run deploy ${name}
 ```

docs/template/agent.md

@@ -23,7 +23,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=agent
+mise run deploy agent
 ```
 
 ## Features

docs/template/api.md

@@ -22,7 +22,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=api
+mise run deploy api
 ```
 
 ### Endpoints

docs/template/eventbridge.md

@@ -23,7 +23,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=eventbridge
+mise run deploy eventbridge
 ```
 
 ### Data models

docs/template/graphql.md

@@ -23,7 +23,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=graphql
+mise run deploy graphql
 ```
 
 ## Implementation

docs/template/s3.md

@@ -22,7 +22,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=s3
+mise run deploy s3
 ```
 
 ### ProcessedMessage model

docs/template/sqs.md

@@ -23,7 +23,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=sqs
+mise run deploy sqs
 ```
 
 ### Data models

docs/template/stream.md

@@ -24,7 +24,7 @@ The template sets up:
 Deploy the stack using:
 
 ```bash
-make deploy STACK=stream
+mise run deploy stream
 ```
 
 

mise.toml

@@ -43,6 +43,13 @@ alias = "n"
 
 [tasks.rename]
 description = "Rename project (run once)"
+usage = """
+flag "--name <name>" help="Project new name"
+flag "--description <description>" help="Project short description"
+flag "--author <author>" help="Author name"
+flag "--email <email>" help="Author email"
+flag "--github <github>" help="GitHub username"
+"""
 run = "uv run rename"
 
 ##### Dev setup and maintenance #####