Docs

Planning

Tasks that know which file they're about.

Planning has three tabs. Dashboard is the project's front page — cover, deadline countdown, progress, activity, notes, your pinned favorites. Tasks is where work gets managed, as a Kanban or a calendar. Manage is the project's data model — people, the status pipeline, attributes and the Smart-attributes bench — in one place.

Your to-do list is a file

Tasks live in .plaza/planning/todos.md — a plain markdown checklist, one line per task, metadata tucked into a trailing comment. That means your task list syncs like everything else, survives Plaza's absence, and can be bulk-edited in any editor — or handed to an AI assistant (AI & local API). Plaza merges concurrent edits per task: two people working the same list keep both sets of changes, and the newest edit to the same task wins.

Capturing tasks fast

Every add-task input understands trailing shortcuts: !1–!3 sets priority, #doing sets status (any unique prefix of a status name works), and a natural date — today, tomorrow, fri, next week, jul 12 — sets the due date. So Comp pass !2 #doing fri lands as a priority-2 task, in Doing, due Friday. Words inside the title are never eaten; only trailing tokens count.

The Kanban

• Columns are yours — the Status pipeline by default, or group by Stage, Shot, Assigned or any tag attribute. Add, rename, recolor, delete and drag-reorder columns right on the board.
• Cards carry their essentials — status, due date, priority, assignees, and a linked file with its real thumbnail.
• Drag a card between columns to change its value; adding a task inside a column starts it with that column's value.
• Color by any attribute tints cards — color by Assigned and a two-person task wears both colors.
• Filter the board by text, assignee or priority from the toolbar.

Week & Month

The same tasks on a calendar: drag tasks between days to reschedule, add a task directly on a day, and hide weekends when they're not working days. Hide done clears finished work off both the board and the calendars. A task chip's single click jumps to it in Week view; double-click renames it.

Select many, edit once

Ctrl/⌘-click cards to build a selection, or drag a marquee across empty board space. A floating bar applies Status, Assign, Due date, Priority, Link file or Delete to everything selected at once. Esc clears.

Tasks that watch your files

Link a task to a file and the link is by stable identity — it survives renames. When a newer version of the linked file appears on disk, the card grows an Update · v015 chip; one click points the task (and its thumbnail) at the new version. Deleting a task offers Undo in the toast.

Notes

Planning keeps a notes pool (markdown files in .plaza/documents/, hidden from the file browser) with a starter Notes.md per project. Notes open in a full-width editor; a note can graduate into the real project by moving it into a project folder. The Dashboard's Notes widget shows the pool, newest first.

Manage

People — everyone who opens the project appears here and in "Assigned to" (People & sharing). Status — the pipeline drawn as proportional segments (width = how much work sits in each), drag to reorder the flow. Attributes — create, rename, recolor and retire tags with live usage counts. Smart attributes — the filename bench (Smart attributes).